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1. INTRODUCTION 



The Real-Time MONITOR for SDS 900 Series and 9300 
Computers is a comprehensive system for monitoring and 
controlling assemblies, compilations, and other program 
operations. Some of its outstanding features are: 

• efficient system operation with minimum operator in- 
tervention; 

• an easy-to-use, on-line, real-time input/output facil- 
ity having maximum efficiency, while taking into ac- 
count the needs of the user's program (I/O operations 
are performed simultaneously with the user's program); 

• an open-ended set of processors that include the SDS 
META-SYMBOL assembler and SDS FORTRAN IV; and 

• a system of diagnostic routines, including highly sel- 
ective program dumps. 

Rapid Access Disc (RAD) Files are used as the storage medi- 
um for MONITOR, the processors that it controls, library 
routines, and system scratch and user files. MONITOR is 
also available in a magnetic-tape version, for use with 
systems that do not have RAD Files. If the tape version of 
MONITOR is used, loading to the secondary library cannot 
be accomplished by MONITOR, since the secondary library 
must be created at system generation time. Also, any ref- 
erences (in this manual) to HOLD files, sequential disc 
files, and random access disc files are not applicable to the 
tape version of MONITOR. All other facilities, however, 
are provided (see Appendix B), 

All major elements of MONITOR are stored on the RAD 
Files in such a way that they are always available to the 
system. Accordingly, these elements are said to be system 
resident. The system resident feature, among others, en- 
ables MONITOR to operate in real-time, providing the user 
with a time-sharing environment in which to solve both 
real-time and nonreal-time problems. The full real-time 
processing capability of the hardware is utilized through 
interrupt control, with a minimum of effort on the part of 
the user. Batch processing functions, such as the compila- 
tion of FORTRAN IV programs and the assembly of SYM- 
BOL/META- SYMBOL programs, are provided also. Both 
forms of processing may be carried out intercurrent ly, i.e., 
allowing interrupt service routines to be resident while 
batch processing functions are carried out, preempting con- 
trol when an interrupt occurs, and restormg control to the 
batch processing function when interrupt servicing is com- 
pleted. 

FEATURES 

BATCH PROCESSING 

Except for the servicing of interrupts, all operations are 
considered to be in the batch processing mode. A batch 
processing function may be "swapped out" if its storage Is 
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ferred to as MONITOR, as distinct from "the monitor" which 
is a primary control portion of the system. 



needed by an interrupt service routine. An interrupted func- 
tion will resume execution from the point of interrupt, after 
the interrupt has been serviced completely. A portion of 
RAD storage is reserved for the "swap out" operation. 

Files used during batch processing are protected from des- 
truction by interrupt service routines for the duration of the 
job. Conversely, files that have been reserved explicitly 
for interrupt servicing may not be accessed by batch process- 
ing functions. When interrupt service routines are resident 
in core memory, batch processing jobs are prohibited from 
doing "compile and go" operations. This is done to protect 
resident real-time programs from destruction by batch job 
execution. 

REAL-TIME PROCESSING 

Any interrupt service routine may be made resident in core 
storage if sufficient storage is available. References to pri- 
mary library routines within such resident programs are sat- 
isfied at the time that they are loaded. References to other 
routines are satisfied at execution time, by dynamically 
loading the referenced program into unused storage. Such a 
dynamic load may cause an interrupted batch job to be 
"swapped out" if sufficient storage is not otherwise available. 
Routines that have been dynamically loaded may themselves 
cause dynamic loading of other routines. 

Core storage used by resident interrupt service routines can 
be protected through use of the optional Memory Protection 
Feature. 

DISC FILES 

The user may define his own disc files. Such files may be 
either random access or sequential. Sequential files can be 
considered to be simulations of magnetic tape files. Conse- 
quently, it is possible to have essentially device-independent 
files defined in a program, and to determine the device at 
the time of execution. 

GENERAL DESCRIPTION 

The main elements in the MONITOR system are a resident 
monitor, a FORTRAN IV processor, a SYMBOL assembler, a 
META-SYMBOL assembler, an overlay loader, a memory 
dump program, an I/O processor, a primary library, a sec- 
ondary library, and an update program. 

RESIDENT MONITOR 

The resident monitor consists of an executive, an interrupt 
monitor, a reentrance monitor, a system bootstrap program, 
and a resident loader. 

Executive 
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all control messages. Provision is made, in the executive, 
for symbolic access to resident user programs. 



Interrupt Monitor 

The interrupt monitor controls all interrupt processing. When 
an interrupt occurs, the interrupt monitor saves hardware and 
program status information and performs other functions before 
turning control over to the appropriate interrupt service rou- 
tine. After completion of the interrupt service routine, the 
interrupt monitor restores the previous program and hardware 
status in the computer, clears the interrupt, and returns control 
to the point in the program at which the interrupt occurred. In 
addition to program status information, each interrupt save 
block includes the contents of the following registers: 

1. A register 4. FORTRAN double-precision register 

2. B register 5. FORTRAN complex register 

3. X register(s) 6. Location (900 Series only) 

Interrupt save blocks are placed in dynamic storage, and 
are restored following the servicing of each interrupt. 

The interrupt monitor is itself interruptable and reentrant. 
All pointers, counters, etc., that are interrupt- level de- 
pendent are contained withing the interrupt monitor as tem- 
porary storage locations (temps), and are thus saved when- 
ever the interrupt monitor is interrupted. These include 
storage allocation pointers, the interrupt level counter, re- 
entrance list pointers, and so forth. 

Reentrance Monitor 

The reentrance monitor determines whether or not a subpro- 
gram is being reentered as the result of an interrupt. When 
this is the case, the reentrance monitor saves the previous 
status of the routine before allowing it to be reentered. The 
local variables, temps, return address, calling argument 
addresses, etc., are stored in a push-down list. Each item 
in the reentrance push-down list is chained to the previous 
item, so that the interrupt monitor can scan the list when 
operations are complete at the end of each interrupt level 
and restore the information saved at that level. 

System Bootstrap Program 

The system bootstrap program is an absolute program that 
can read itself into core memory from disc storage. It 
causes the MONITOR to be read into core memory and 
causes the executive wait loop to be entered. 

Resident Loader 

The resident loader consists of a loader control program, a 
semiabsolute loader, an implicit call processor, and vari- 
ous utility routines. It is used to load all programs from 
the system files, including programs from the primary lib- 
rary, the secondary library, and the overlay file. 

REAL-TIME FORTRAN IV 

The FORTRAN IV processor will operate in real-time and is 
ASA compatible. 

META- SYMBOL ASSEMBLER 

The META-SYMBOL assembler translates source programs, 
written in symbolic code, into machine language programs. 

SYMBOL ASSEMBLER 

The SYMBOL assembler is similar to the META-SYMBOL as- 
sembler, but without some of the letter's advanced features. 



OVERLAY LOADER 

The overlay loader converts relocatable programs into a 
form suitable for loading. It allows the loading and oper- 
ating of a program in segments. 

MEMORY DUMP PROGRAM 

The memory dump program can be called during batch pro- 
cessing as the result of a control message. A dump may be 
taken of any specified area of memory and the information 
dumped is in octal format. 

SYSTEM I/O PROCESSOR 

The system I/O processor is a general I/O package that is 
used to process all input/output functions, including system 
requests. All I/O operations occur on a first- come- first- 
served basis; and an operation, once started, continues to 
completion. Prior to the start of any I/O operation, an in- 
terrogation is made to determine whether or not the physical 
file has been reserved. If the file has been reserved, and if 
the request is from a resident program, the request is ser- 
viced; otherwise, an error message results. 

PRIMARY LIBRARY 

The primary library consists of user routines such as mathe- 
mCitical routines and FORTRAN I/O and system routines. 
Other routines may be added at the user's discretion. A de- 
bug program is provided as a standard feature and includes 
such facilities as tracing, patching, snapshots, memory dis- 
play, and address search. 

SECONDARY LIBRARY 

The secondary library includes user routines such as interrupt 
service routines and batch processing production programs. 

UPDATE PROGRAM 

The update program, accessed by means of control messages, 
has the ability to perform the standard file maintenance 
functions of insertion, deletion, and replacement. It may 
be used for both system and user file updates. 

HARDWARE REQUIREMENTS 

MONITOR will function in any SDS 900 Series/9300 Com- 
puter having at least 16K words of core memory. The META- 
SYMBOL assembler requires 12K words of memory. If there 
are to be no real-time resident programs and if META- 
SYMBOL is not to be used, the minimum required memory 
for MONITOR is 8K words. If real-time programs are to be 
in residence, at least 12K wordsare required. 

The system requires interlace on each channel or buffer con- 
trolling: 

1 Typewriter 

1 Magnetic Tape Unit 

1 Card Reader 

1 Rapid Access Disc File (524K characters.) 

MONITOR has provisions for using the optional memory 
protection, multiple memory bank, and power- fail -safe 
features. 



2. MONITOR CONTROL MESSAGES 



The user directs and controls MONITOR via control mes- 
sages. These messages direct the construction and execu- 
tion of programs and provide the link between the program 
and its environment. The environment includes MONITOR 
and its processors, the computer operator, and peripheral 
equipment. 

The control messages are 



System Control 


Loader Control 


JOB 


SEG 


ASSIGN 


INCLUDE 


RELEASE 




DATE 


Sequential File Subcontrol 


TITLE 




MESSAGE 


BACKSPACE 


LABEL 


REWIND 


PAUSE 


ENDFILE 


Processor Control 


Operator Control 


METAXXXX 


ABORT 


SYMBOL 


GO 


FORTRAN 


RETRY 


LOAD 


ERROR 




CONNECT 


Input Control 




EOF 




DATA 




FIN 





Control messages have the general form 



AMNEMONIC SPECIFICATION 



A space must follow the mnemonic, and no spaces are al- 
lowed within the mnemonic. 

Columns 73-80 are not interrogated and may be used for 
identification. 

SYSTEM CONTROL MESSAGES 

JOB JOB signals the completion of the previous 

job and the beginning of a new job. 

AJOB X...X 



X. . .X is any field desired by the user. Provision is made 
for the insertion of installation accounting routines. 



i.e., those monitoring the running characteristics of 
the jobs performed such as running time, units used, 
output quantity produced, etc. 

When a job message is encountered, all user's operational 
labels (relating to a previous job), are deleted from the 
operational table. 

ASSIGN ASSIGN provides for equating logical peri- 

pheral device names, designated by the user, to physical 
peripheral device names permanently established for the 
system. The operator normally generates ASSIGN cards 
from programmer-supplied job request information. 



AASSIGN A=B(N), RESERVE, HOLD 



A is a symbolic file name of from 1 to 8 characters, 

designated by the user. 

B is either a symbolic file name or else the permanent 

symbolic unit name of an attached physical unit. If 
B is a symbolic file name, it must have been defined 
previously. 

(N) is a numeric constant which specifies a maximum 

size, in words, of disc storage to be allocated to 
this file. A size must not be specified for files not 
assigned to disc storage or for sequential disc files. 
A size must be specified for all random-access disc 
files. If B is a symbolic file name, (N) must not 
be specified. 

RESERVE may be used when assigning files to be used 
by real-time programs only. The RESERVE option 
specifies that the file named may be read or written 
by real-time programs only. 

HOLD applies to disc storage only. If a file is assigned 
to disc storage, it will become a permanent file 
whenever HOLD is specified and will remain on 
disc storage until released by a ARELEASE message. 



B 


Device 


MD 


Magnetic drum 


MT 


Magnetic tape 


CP 


Card punch 


CR 


Card reader 


PP 


Paper tape punch 


PR 


Paper tape reader 


TY 


Typewriter 


LP 


Line printer 


DF 


Disc file 


PL 


Plotter 


NO 


No I/O desired 



The user may fill an ASSIGN card with as many complete 
assignments as will fit; no continuation is allowed. 

Examples: 

AASSIGN ABBC=MT2A, QRZ=ABBC, 2=DF1A(5000) 

Assign the magnetic tape 2 on channel A to the label ABBC, 
assign the label ABBC to the label QRZ, assign disc file 1 
on channel A to the label 2 and allocate 5000 words of disc 
storage. 

AASSIGN ABC=MT3A,TYP=TY1A 

Assign the magnetic tape 3 on channel A to the label ABC 
and the typewriter 1 on channel A to the label TYP. 

Note that magnetic tape units are numbered through 7; all 
other devices are numbered from 1 . 

MONITOR -defined system labels may be used as labels in 
ASSIGN control messages. 

The complete set of standard file names that may be used 
with ASSIGN control messages (or RELEASE control messages 
explained below) are as follows: 

System Labels 



files not assigned to disc storage results in a reservation of 
the physical unit being assigned. 

MONITOR accomplishes the reservation of files assigned to 
disc storage by allocating a disc storage area, of the re- 
quired size, and adding the FCB to a table of FCBs on disc. 

RELEASE RELEASE pertains to HOLD disc files or to 

those files that have been reserved. 

ARELEASE A, A, A, A 



A is a symbolic name of from 1 to 8 characters. 

RELEASE instructs MONITOR to release the specified file(s) 
from its previous assignment. 

DATE DATE gives MONITOR the date to be used 

for heading outputs. The date is also listed on the LO (list- 
ing output) media after each JOB card. (The assignment of 
a device as the one on which listing output is to be produced 
is explained under "Processor Control Messages. ") 

ADATE DAY, MONTH, YEAR 



Label 


Reference 


Reassign - 
able? 


R\PROC 


Processor file 


No 


R\PROK 


PROC deck file 


No 


R\PRIL 


Primary library file 


No 


R\SECL 


Secondary library file 


No 


R\OVRL 


Overlay library file 


Yes 


R\PERM 


Permanent file 


No 


R\CONS 


System typewriter 


No 


R\SWAP 


Swap file 


No 


R\DUMP 


Post-mortem -dump file 


Yes 


C 


Control message input 


Yes 


Xi 


Scratch files, where 






i=1,2,3,... 


Yes 


SI 


Symbolic input 


Yes 


so 


Symbolic output 


Yes 


EI 


■ Encoded input 


Yes 


EO 


Encoded output 


Yes 


LO 


Listing output 


Yes 


GO 


Binary output for load-and-GO 


Yes 


BI 


Binary input 


Yes 


BO 


Binary output 


Yes 


TY 


Typewriter 


Yes 


NO 


No I/O operation 


No 



Assignment, release, and reservation of files is accomplished 
through the use of File Control Blocks (FCBs) which commu- 
nicate information about files to the system I/O handler. 



DAY is a 1 - or 2-digit number. 

MONTH is a 3-letter abbreviation; if it is expressed, DAY 
must also be expressed. 

YEAR is a 4-digit number; if it is expressed, MONTH 
must also be expressed. 

TITLE The TITLE control message may appear any- 

where after a JOB message and before a LOAD message. The 
purpose of the TITLE control message is to produce a heading 
at the beginning of each page on the LO media. MONITOR 
begins counting headed pages whenever a TITLE control mes- 
sage appears, and it incorporates this information into the 
heading. 

' ATITLE 



The contents of columns 9 through 72, the current date, and 
the number of the page appear at the beginning of each new 
page on the LO media. 

MESSAGE The MESSAGE control message may appear 

anywhere. 

AMESSAGE '"" 



Reservation of a file by MONITOR is accomplished by set- 
ting the reserve bit in the FCB for that file. Reservation of 



The contents of columns 1 through 80 are output on the sys- 
tem console typewriter and on the TY device (if not the some 
as the system console), and LO devices specified by pro- 
cessor control cards. 

LABEL The LABEL control message may appear any- 

where before the processor and LOAD control messages. 
The LABEL control message enables the user to write a la- 
bel on the GO file (i.e., the file used to store the binary 
listing output in assemble-and-execute or compile-and 
execute processing) preceding the binary object code. 

ALABEL X...X 



I/O Specifications (cont. ) 



X. . .X is the label to be written on the GO file. It may 
be up to 8 characters in length. 

PAUSE The PAUSE control message causes MONITOR 

to wait for an operator response before continuing, allow- 
ing time for the operator to perform some manual function 
(such as changing a tape reel). 

APAUSE MESSAGE 



This control message will cause the message 

* PAUSE* TYPE AABORT, AGO 

to be produced on the system console preceded by the 
MESSAGE, and will cause the program to loop until the 
operator responds. (See Operator Control Messages.") It 
may occur anywhere. 

PROCESSOR CONTROL MESSAGES 

Processor control messages tell MONITOR what system, such 
as FORTRAN, is to be used with the input deck to follow. 
Any processor message also contains a list of input and out- 
put specifications to be used during the assembly or com- 
pilation. 

The complete set of I/O specifications that are recognized 
by MONITOR are given in the following table. 

I/O Specifications 



M 


Specification Reference 


EI 


Encoded input 


EO 


Encoded output 


SI 


Symbolic input 


SO 


Symbolic output 


LO 


Listing output or listing object 



M 


Specification Reference 


LS 


Listing source 




BO 


Binary output 




X 


Compile X cards 




GO 


Binary output for load-and-GO 




S 


SYMBOL- type symbolic statements 




C 


MONARCH compatibility 




ASA 


ASA standard storage allocation 




CONC 


Standard concordance listing 




EXCP 


Concordance listing with exceptions 




910 


Defines CPU for which code is to be 


gener- 


920 


ated. (900 Series FORTRAN IV only 


) If 


925 


unspecified, generated code will be 


for 


930 


CPU on which compiler is operating. 





METAXXXX METAXXXX specifies to META-SYMBOL 

which type of inputs and outputs the program requires. 

AMETAXXXX M,M, ...,M 



XXXX 



M 



is 920, 9300, or 910. META920 produces output for 
the 920/930. MET A9300 produces output for the 
9300 and META9 10 produces output for the 9 10/925. 

is the input/output specification. 
META-SYMBOL I/O Specifications 



M 


Specification Reference 


EI 


Encoded input 


SI 


Symbolic input 


LO 


Listing output 


GO 


Binary output for load-and-GO 


BO 


Binary output 


EO 


Encoded output 


SO 


Symbolic output 


C 


MONARCH compatibility 


CONC 


Concordance listing (standard) 


EXCP 


Concordance listing with exceptions 



With the METAXXXX message: 

The user writes the specifications (M, M, . . . , M) sepa- 
rated by commas, in any order. 

Once established, a set of options remains in force through- 
out the job until changed by a new processor control message. 

Note: If the encoded and symbolic input ore from the 
same source, a second scratch file for META- 
SYMBOL is required. 



SYMBOL 



The SYMBOL control message directs 



MONITOR to load and transfer cuntrul to the SYAvABOl 
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ASYMBOL P1,P2 



PI is 920, 9300, or 910 (920 produces output for the 

920/930, 9300 produces output for the 9300, and 
910 produces output for the 910/925). 

P2 specifies output data parameters. The parameters 

(LO and/or BO) may appear in any order, sepa- 
rated by a comma. 

At least one output parameter (P2) must be present. Since 
symbolic input is assumed, SI is not used as a parameter. 

FORTRAN The FORTRAN message informs MONITOR 

that the FORTRAN IV compiler is to be used to process the 
source deck. 

AFORTRAN M,M, ...,M 



M specifications, separated by commas, may be writ- 

ten in any order and have the configurations and 
meanings given in the table of FORTRAN IV I/O 
Specifications. 

With FORTRAN, symbolic input (SI) is always assumed. If 
the user requests the LO option together with the LS option, 
the listing occurs in the order: source then object. The la- 
bel X refers to FORTRAN IV conditional compilation (X in 



column 1) cards. The presence of the label X causes FORTRAN 
to compileX cards. Otherwise, it treats them as comment cards. 

FORTRAN IV I/O Specifications 



M 


Specification Reference 


SI 


Symbolic input 


BO 


Binary output 


LS 


Listing source 


LO 


Listing object 


ASA 


ASA standard storage allocation 


X 


Compile X cards 


GO 


Binary output for load-and-go 


S 


SYMBOL-type symbolic statements occur on 




"S" cards in a FORTRAN program 


SO 


Symbolic output (for 9300 FORTRAN only) 


910 


Defines CPU for which code is to be gener- 


920 


ated. If unspecified, generated code will 


925 


be for the CPU on which the compiler is 


930 


operating. (900 Series FORTRAN only.) 



Several FORTRAN programs can be compiled without preced- 
ing each one with a FORTRAN control message. Each subse- 
quent FORTRAN program uses the same M specifications 
encountered in the last FORTRAN control message. 

LOAD The LOAD control message causes MONITOR 

to use the loader to load programs. 

ALOAD M,M, ...,M 





Specifications for LOAD Control M 


essages 


M 


Specification Reference 


Precludes Use of Specifications 


'name' 


Load named routine from secondary library into core 


SECLIB 


UPPER 


Load from input medium into upper residence core area 


LOWER, SECLIB, X, XM, XR, MlOO 


LOWER 


Load from input medium into lower residence core area 


UPPER, SECLIB, X, XM, XR, MlOO 


SECLIB 


Load from input medium (except secondary library) into secon- 


•name', UPPER, LOWER, X, XM, XR, MlOO, 




dary library 


BI 


X 


Load from input medium into core and execute only if error- 
less 


UPPER, LOWER, SECLIB, XM, XR 


XM 


Load from input medium into core and execute only if no 
major errors 


UPPER, LOWER, SECLIB, X, XR 


XR 


Load from input medium into core and execute regardless of 
errors 


UPPER, LOWER, SECLIB, X, XM 


MlOO 


Origin of relocatable programs to be a multiple of octal 100 
(except for overlay and library routines) 


UPPER, LOWER, SECLIB 


MAP 


Produce load map 




BI 


Search BI file for referenced 'name'; if not found, search 
SECLIB. 'name' must be specified if BI is used. If 'name' 
cannot be found on BI or SECLIB, an error message will be 
printed 


SECLIB 



M specifications, separated by commas, may be writ- 

ten in any order. The various M specifications are 
shown in the table on the preceding page. 

The 'name' used as a specification in a LOAD control mes- 
sage must be the defined name of a routine in the secon- 
dary library. If a 'name' is specified, the specification 
SECLIB must not be used in the same LOAD control message. 
An example of the use of a 'name' is given below. 

ALOAD X, 'name' 

The above message would cause the named routine to be 
loaded from the secondary library into core memory and 
executed only if free from errors. The lackof an Xspecifica- 
tion (either X, XM, orXR) would cause the named routine to 
be loaded into core memory but not executed. 

If no 'name' is specified, MONITOR loads from the GO 
file if the GO file contains any binary code to be looded. 
If the GO file contains no binary code, MONITOR then 
loads from the BI file. An example is given below. 

ALOAD UPPER, MAP 

The above message would cause the binary code from 
the input medium (i.e., the GO file, if possible, or 
else the BI file) to be loaded into the highest available 
resident core area. No execution of the loaded binary 
code would result, but a listing, or "map" of the rela- 
tive locations of all external definitions would be print- 
ed out on the system console typewriter at load time. If 
the specification LOWER were used, rather than UPPER, 
the binary code would be loaded into the lowest avail- 
able area of resident core memory instead of the high- 
est. Note that the specifications UPPER and LOWER 
must not be used in conjunction with any of the X speci- 
fications, since resident core storage is not intended to 
be used for batch processing. 



LOADER CONTROL MESSAGES 

SEG A segment of a program is that portion of mem- 

ory that is committed by a single reference. A segment usu- 
ally overlays some other segment and is constructed from sub- 
segments. A fixed segment is that portion that resides in core 
memory at all times. Any number of SEG cards may be used 
to define the program, but they must be in sequence. (See 
"MULTIPLE SEG CARDS".) 

Segmentation may be specified by use of the following sym- 
bols on a SEG control card: 

labels one to eight alphanumeric characters that are 

the labels of segments. 

indicates that two segments or segment levels 
are to be consecutive in memory. 

, indicates that two segments are to overlay 

each other (begin at the same point). 

( ) indicates a grouping. 

; indicates that another SEG card follows. 

MULTIPLE SEG CARDS 

The special terminator 0) is used to continue from one SEG 
card to another. 



z 



ASEG ,D) 



ASEG A-E-(A,C; 



ASEG A-E-(B,C,D) 



. Multiple SEG 
Cards 



Single SEG Card 



If SECLIB is specified, the binary code from the input medi- 
um is loaded into the secondary library. An example is 
given below. 

ALOAD SECLIB, MAP 

Note that the only other load specification that may be used 
in conjunction with SECLIB is MAP (when a load map print- 
out is desired). 

The specification BI may be used in conjunction with any 
other load specification except SECLIB. When BI is speci- 
fied, a 'name' must be specified also. The named routine 
is loaded from the BI file or, if it is not found there, from 
the secondary library. 

On completion of loading from the input source, the load- 
er attempts to fulfill any unsatified references by search- 
ing the primary library. The routines that satisfy such 
references are added to the program. All other refer- 
ences are treated as implicit calls, i.e^ references to 
undefined external symbols at load time (see "Implicit 
Call Processor"). 



Comments may appear on a SEG card, provided that a semi- 
colon is used to terminate the segmentation codes and the 
comments field begins at the right of the semicolon. Com- 
ments may not appear on the last SEG card. 



INCLUDE The loader normally allocates labeled COM- 

MON blocks in the highest levels in which they are refer- 
enced. Library routines are usually loaded at the highest 
level (see Section 3). However, the user may allocate la- 
beled COMMON blocks and library routines at any subse- 
quent level by the use of the INCLUDE control card. 



AINCLUDE NAME/LABEL 1,LABEL2,,,,,LABELN 



NAME is the 1 to 8-character label used to define the seg- 
ment in which the blocks or routines are to appear. 

LABEL is the label used to define the routine or COMMON 
block. 



SEQUENTIAL FILE SUBCONTROL MESSAGES 



AEOF 



BACKSPACE BACKSPACE pertains to magnetic tape or se- 
quential disc files only. 

ABACKSPACE A, A,..., A 



A is a symbolic name of from 1 to 8 characters rep- 

resenting a file on a magnetic tape or disc file 
(sequential file). 

BACKSPACE instructs MONITOR to backspace 1 physical 
record on the specified file(s). 

REWIND REWIND pertains to magnetic tape or se- 

quential disc files only. 

AREWIND A, A,..., A 



Note: An EOF card must follow symbolic input foraMETA- 
SYMBOL assembly that involves both symbolic and 
encoded input. No EOF cards are needed for FOR- 
TRAN compilations. 

FIN The user places a FIN control card at the end 

of a stack of jobs, to inform MONITOR that no more informa- 
tion will be received from the C input device. When this 
card is encountered, all user's operational labels are deleted 
from the operational label table 

AFIN 



A is a symbolic name of from 1 to 8 characters. 

REWIND instructs MONITOR to rewind the specified file(s). 

ENDFILE ENDFILE pertains to magnetic tape or se- 

quential disc files only. 

AENDFILE A, A,..., A 



At this point, MONITOR types a message to inform the op- 
erator that it has completed a stack of jobs and that it re- 
quires more information. 

OPERATOR CONTROL MESSAGES 

After the message field of a APAUSE control message is out- 
put on the system console typewriter, or after the system 
abort routine (R\ABRT) has been called, one of the following 
MONITOR messages is typed: 

* PAUSE* TYPE AABORT; AGO 



A is a symbolic name of from 1 to 8 characters. 

ENDFILE instructs MONITOR to write an end-of-file at the 
current position of the specified file(s). 

INPUT CONTROL MESSAGES 

DATA The DATA control card informs the system 

that there is a data deck to follow. The data deck is for use 
by the executing program. If a DATA control card appears 
in the normal sequence of control cards, other than just 
prior to a data deck, it is ignored. 

ADATA 



EOF An EOF card is a terminator for an input 

source; it separates different types (EI or SI) of input data. 
If this card appears in the normal sequence of control cards, 
it is ignored. 



*PAUSE* TYPE AABORT; AGO; ARETRY 



♦PAUSE* TYPE AABORT; AGO; ARETRY; AERROR 

In response to such a MONITOR message, the operator types 
one of the following (as specified by the message): 

1. AABORT C/R (C/R = carriage return) 

2. AGO C/R 

3. ARETRY C/R 

4. AERROR C/R 

If AABORT is typed by the operator, MONITOR then causes 
the current job or interrupt service routine to be discontinued 
and one of the following MONITOR messages is typed: 

*JOB ABORTED* 



*INTERRUPT ABORTED* 



If AGO is typed, the current job or interrupt service routine 
will continue from the point at which it was halted by the 
APAUSE control message. 

A ARETRY message causes the appropriate retry routine to 
be entered, and a AERROR message causes the appropriate 
error routine to be entered. 



USER-DEFINED CONTROL MESSAGES 

The user may define his own control messages, in the follow- 
ing form: 

AX. ..X M,M,...,M 

An unrecognized control message will cause a transfer to 
the program of that name, if such a program is in core at 
the time that the message is received by MONITOR. 

The specification fields (M, M, . . . , M) of an unrecognized 
control message can be processed by the user via the 
MONITOR scan (R\SCAN), symbol table search (R\RSTS), 
and convert (R\CNVT) routines. (See Section 8.) 



SYSTEM RESERVED NAMES 

Names reserved for control messages (i.e., Aname) must not 
be used as external definitions. This includes control mes- 
sage names used in debugging. 

CONNECT CONTROL MESSAGE 

The CONNECT control message is used to associate a partic- 
ular subroutine with a given interrupt location. (See Section 
5.) It has the following form: 

ACONNECT (loc, sub(arg ^, . . . , arg^)) 

loc is an octal integer specifying the interrupt location. 

sub is the name of the subroutine to which control is to 

be given when interrupt loc occurs. 

org. is the normal argument list used with the subroutine, 

including any symbolic name that has been defined 
(i.e., the external definition has been loaded into 
core). That is, the argj may be names of GLOBAL 
variables or of subprograms. 



3. LOADING 



BATCH JOBS WITHOUT OVERLAY 

The arrangement of a typical program deck for an unseg- 
mented job is shown below. Note that, although no SEG 
or INCLUDE control messages are needed in this example, 
an INCLUDE control message may be used to force the load- 
ing of a routine from the primary library. 



Examples: ASEG A-(B-(C, D, E), F-(G, H)) 



X 



Next Card 



Binary Decl<(s) 



ALOAD X,MAP 



In the above example, the GO file is assumed to contain 
no binary code; the binary-coded cards are loaded, a load 
map is printed out on the system console typewriter, and 
the program is executed. 

BATCH JOBS WITH OVERLAY 

The following examples represent segments diagrammatically 
as "trees". The horizontal coordinate is used to denote in- 
creasing memory allocation and decreasing segment levels 
from left to right; a vertical coordinate is used to denote 
overlays. 

Example 1: If a program has a main segment labeled A and 
two overlays, segments B and C, the program could be dia- 
grammed as: 



H 



The arrangement of a typical program deck for a segmented 
job is shown below. Note that an INCLUDE control card is 
used to load a table, from the primary library, with a speci- 
fied segment. 



X 



Next Card 






Binary Deck(s) 



ALABEL NAMES 





C 










A 










B 



Binary Deck(s) 



ALABEL NAME2 



and could be described as ASEG A-(B, C) 
Example 2: ASEG A-(B-(C-D, E), F) 







C 


D 














B 












A 


E 














F 







Binary Deck(s) 






ALABEL NAMEl 






AINCLUDE NAMES/TABLE 1 




ASEG NAME 1-(NAME2, NAMES) 


AL 


OA 


D 


X^AAAP 



The above example would result in the overlay structure 
shown in the diagram below. 



See Section 4. 





NAME2 










NAMEl 










NAMES 


TABLE! 
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LOADING TO AND FROM SECONDARY LIBRARY 

LOADING TO SECONDARY LIBRARY 

The arrangement of a typical program deck to be loaded into 
the secondary library is shown below. Note that any rou- 
tine loaded to the secondary library must have at least one 
external definition. 



Next Card 



Binary Deck(s) 



ALOAD X,SECLIB 



LOADING FROM SECONDARY LIBRARY 

Loading from the secondary library can be accomplished by 
means of one of the following control messages: 



1. ALOAD 'name' 

2. ALOAD X, 'name' 

3. ALOAD X, 'name',BI 

Note that if BI is specified, loading will be from BI, and if the 
named routine is not found on the BI media, then the secon- 
dary library will be searched for the named routine. Any of 
the LOAD specifications not precluded by use of a 'name' 
specification may be incorporated In the control message. 



LOADING RESIDENT, REAL-TIME PROGRAMS 

Typical control messages for loading programs into resident 
storage for interrupt servicing are as follows: 

1. ALOAD X, UPPER 

2. ALOAD X, 'name', LOWER 

3. ALOAD X, 'name', BI, UPPER 

Note that specifying UPPER or LOWER causes the program 
to be loaded into upper or lower resident core memory, 
respectively. (See Section 5 for details of real-time op- 
erations.) 



n 



4. PREPARING THE PROGRAM DECK 



The following samples show various ways to prepare program 
decks for MONITOR operation, 

META-SYMBOL INITIAL ASSEMBLY 



Symbolic Input SI 
Listing Output LO 
Encoded Output EO _ 



•Next Card' 



Note: 



Symbolic Program Unit 



AMETA930 SI,EO,LO 



AASSIGN X1=MT1A,X2=MT2A 



AASSIGN SI=CRlA,LO=LPlA 



AJOB FORS AMP, 4331 

The "next card" must be another control message 
such as JOB or METAXXXX, etc., denoting the 
beginning of the next program unit. In all cases of 
assembly following assembly (namely, EI to EI, EI 
to SI, SI to SI, or SI to EI), the subsequent source 
input decks must be preceded by a METAXXXX 
card. 



FORTRAN COMPILATION 



(Symbolic Input SI Assumed) 
Listing Source LS 



"Next Card" 



FORTRAN Program Units 



AFORTRAN LS 



AASSIGN X1=MT1A,X2=MT2A 



AASSIGN SI=CR1A,LO=LPlA,EO=CPlA 



AJOB SAMP, 4331 



LS is on the LO medium. 

The "next card" functions for FORTRAN as it does for META- 
SYMBOL, except that if it is not a control card, it is assumed 
to be another FORTRAN symbolic input deck with the same 
options as specified In the last FORTRAN control message. 

FORTRAN COMPILE-AND-EXECUTE 



META-SYMBOL ASSEMBLY WITH CORRECTIONS 

Symbolic Input SI 

Encoded Input EI 

Listing Output LO 

Encoded Output EO 



'Next Card' 



Encoded Program Unit 



AEOF 



Symbolic Corrections 



AMETA930 SI,EI,LO, EO 



AASSIGN LO=LPlA,EO=CPlA 



AASSIGN SI=CR1A, EI=CR1A 



AASSIGN X1=MT1A,X2=MT2A 



AJOB SAMP, 4331 



The EOF card separates the two types of program inputs. 
Seethe note concerning "next card" in the previous sample. 



(Symbolic Input SI Assumed) 
Listing Source LS 

Binary Output for Load- 
and-GO 



'Next Card' 



ALOAD X 



FORTRAN Program Units 



AFORTRAN GO,LS 



AASSIGN USER=MT2A 



AASSIGN SI=CRlA,LO=LPlA,GO=MT2A 



AASSIGN X2=MT2A,X1=MT1A 



AJOB FORS AMP, 4331 



The "next card" must be a A control card. 

The USER assignment assigns and reserves a magnetic tape unit 
for execution after program compilation. The GO specifi- 
cation on the FORTRAN card informs the FORTRAN proces- 
sor to generate binary output, for subsequent loading, onto 
the GO file. 

Note that when MONITOR encounters the FORTRAN card, 
control is transferred to the FORTRAN processor. Therefore, 
any control card immediately following the FORTRAN card 
or within the source deck would cause FORTRAN to termi- 
nate compilation. 



OVERLAY PROGRAM EXAMPLE 



An example of an overlay program deck is shown below. 



AFIN 



Data Deck 



<x 



ADATA 



ASEG A-(B,C) 



ALOAD X 



jRelocg 



\J 



ocatable Binary Program Un 



ALABEL C 



<X 



X 



aJHi^na^Uhi^UWMUUI 



Source Program Unit 






AFORTRAN GO,ASA, LS 



ALABEL B 



Encoded Program Unit- 



"|Sym 




V 



AEOF 



Symbolic Corrections 




AMETA930 SI, EI, LO, GO 



ALABEL A 



AJOB 10,4934,20,100 
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MULTIPLE PROGRAM EXAMPLE 



This sample shows some of the many control cards and deck configurations provided in the MONITOR system. 



AFIN 



Data Deck 




ADATA 



ALOAD XM,MAP 



AASSIGN USER=MT2A 



{Symbolic Program Unit X 



|AMETA930 SI, LO,GO 
Source Program Unit 




f " ' ■ " ■ ■ '" c \ 

I Source Program Unit \ > 




AFORTRAN GO,ASA,LS 



Encoded Program Unit 



W" 




]/ 



v 



laM. 



AEOF 



Symbolic Corrections 



JAMETA930 SI,EI,LO,GO,EO 




Encoded Program Unit 



z. 




AEOF 



Symbolic Corrections 



AMETA930 SI,EI,LO,GO, EO 




AASSIGN GO=MT2A 



AASSIGN X2=MT2A 



AASSIGN EO=CPlA 



A 



AASSIGN LO=LPlA 



AASSIGN BI=CR1A 



[AASSIGN EI=CR1A 
[AASSIGN SI^CRIA 
[AASSIGN XI^^MTIA 
AJOB ID \ 
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SYMBOL PROGRAM EXAMPLE 



An example of a SYMBOL program deck is shown below. 



Next Card 




Symbolic Deck 



ASYMBOL 910,LO,BO 



<X 



AASSIGN BO=PPlA,Xl=MTlA 



AASSIGN SI=CR1A,LO=LPlA 



AJOB SYMSAMP 



V 



5. REAL-TIME OPERATIONS 



MONITOR responds to interrupts occurring during the exe- 
cution of batch [obs, or during the execution of other real- 
time service routines of lesser priority, and returns to the 
interrupted task after completion of the interrupt. Provi- 
sions are included for allowing a routine that is responding 
to an interrupt to call any other routines interrupted while 
in process, with no danger of losing data. The various 
interrupt service routines may use a common pool of sub- 
routines. 

Real-time programs are loaded in the manner described in 
Section 3 (see "Loading Resident, Real-Time Programs"). A 
CONNECT control message (see Section 2) causes code to 
be generated as shown in the following example (9300 Com- 
puter): 

ACONNECT (40, SUBR(ARGS)) 

code executed by the CONNECT message processor 

BRM R\CNCT 



PZE 


2 




PZE 


040 




PZE 


entry 




ode generated in dynamic storage 




entry PZE 






DIR 


*,2 




BRM 


R\SV1NTS 




BRM 


SUBR 


calling sequence 


PZE 


1 


for connected 


PZE 


ARCS 


routine 


BRM 


R\RSINTS 




BRC 


*entry 





When an interrupt occurs at location 408 ('" ^^^ above ex- 
ample), it results in the execution of a branch to the entry 
of the calling sequence for the connected routine. 

Any interrupt service routine having external references that 
are not satisfied at load time causes an automatic load of the 
referenced routines from the secondary library when the in- 
struction referencing the routine is executed. 

With the exception of I/O operations, any action performed 
at a given interrupt level will be ceased during the execu- 
tion of a higher- level interrupt and will be returned to when 
all higher- level interrupts have been cleared. 

A RECURSIVE declaration in FORTRAN defines a reentrant 
subprogram. Note that this does not mean that such a pro- 
gram may call itself, either directly or indirectly. 

Any subprogram that can be entered as the result of more 
than one interrupt (before its execution has been completed) 
must be reenterable. Moreover, if a reentrant subprogram 
has internal subprograms, the internal subprograms must also 
be reentrant. Note that a protected routine must not initiate 
any action causing an interrupt to occur during the timespan 
of its own execution (including I/O operations). Also, a 
protected subprogram should not contain an internal, re- 
entrant subprogram. 
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6. DEBUGGING 



The debug package is a part of the primary library. It is 
loaded by using an INCLUDE control message following a 
LOAD control message. A typical example is shown below. 



/ 



Data Deck 



ADEBUG ALPHA(P,Q) 



ATRAC E 



Binary Deck 



AINCLUDE NAME/DEBUG 



ALABEL NAME 



ALOAD MAP 



where p. may be 

1. the name of a subprogram to be "branch" traced 
(i.e., printouts for branches only). 

2. the name of a subprogram followed by an asterisk, 
causing the subprogram to be "full" traced (i.e., 
printouts for all executed instructions). 

3. No Pi need be specified, in which case the trace 
will be a "branch and mark" trace; that is, a trace 
of all BRM instructions. This trace is always given, 
regardless of the pj specified in a ATRACE message. 

As many TRACE messages as necessary may be used, with a 
limit of 25 subprograms named. Also, a breakpoint switch is 
used to allow an on-line user to cause a "full" trace regard- 
less of what control messages have been read. 

TRAP Control Message 

This control message is of the form 



Upon encountering a DEBUG message (see "Debug Control 
Message") the Debug program will immediately begin in- 
terpretive execution of the specified routine. Only the 
specified routine and other routines under Its control will 
be executed. All execution will be done interpretively 
until either (1) the specified routine executes a normal 
return or (2) a LEAVE message is encountered. In either 
case, control is returned to MONITOR. 

DEBUG CONTROL MESSAGE 

The DEBUG control message may specify a complete calling 
sequence, and has the form 



ATRAP 



f f f 
T 2' 3' 



ADEBUG p(a^,a2,a3,...,a^) 



[for 0<n < lO] 



where p is the name of the subprogram at which interpretive 
execution is to begin, and the a? form the list of arguments 
required by the subprogram. The Oj may be any externally 
defined symbol, integer constant, or floating-point constant 
consisting of a whole number followed by a decimal point 
and decimal fraction. Both the subprogram name and the 
argument list are optional, but, if specified, they must be 
defined (i.e., they must be in core storage). If the subpro- 
gram name is not specified, interpretation will begin with 
the entry to the main program. 

DEBUG CONTROL 

The following control messages may be used when the debug 
program is in residence. 



TRACE Control Message 
This control message is of the form 
ATRACE p^,p2,P3, ..., p^ 



[for 0<n < 25] 



where each fj may be either a symbolic instruction or a sym- 
bolic address. The effect of a TRAP message is that, every 
time a specified instruction is used or a specified (effective) 
address is referenced, a trace-type printout occurs. As many 
TRAP messages as necessary may be used, with a total maxi- 
mum of 25 addresses, and a total of 25 instructions. A break- 
point switch may be used by an on-line user to cause a pause 
following each TRAP printout. 

SNAP Control Message 

The format of this message is 

AS NAP e /s /n , Q^s^n^, . . . 

causing a snapshot dump of n; words starting at location sj, 
whenever the instruction in location ej is about to be exe- 
cuted. Both e and s are s/mbolic locations and n is a deci- 
mal number. 

As many SNAP messages as necessary may be used, with a 
maximum of 10 snapshot dumps specified. 

INSERT Control Message 
This message has the form 

AINSERT e/w., w«, w^, ... 

where 

1. the instructions specified (the W|) are to be Insert- 
ed logically following the instruction at symbolic 
location e. 
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2. The Wj may be either octal instructions (8 octal 
digits), or symbolic instructions of the form 

op loc 

where "op" is a symbolic operation and "loc" is a 
symbolic or octal location. 

As many INSERT messages as necessary may be used, but a 
maximum of 200 locations are reserved for insertions. 

CEASE Control Messages 

The format of these messages is 

ACEASE m /a^,m_/a2, mVog, ... 

where m; may be any of the previously defined debug mes- 
sage names, and a- may be any location (or instructions, in the 
case of TRAP) to which the named function has been assigned. 

For example: 

AT RAP ALPHA + 3, STB 

ATRACE BETA, GAMMA*, DE LTA, ALPHA 

AS NAP TW3/RCU/25 

AINSERT SST-4/77350031 

AINSERT SST+8/LDA B, STA D, LDA C,STA W 

ACEASE TRAP/ALPHA+3, SNAP/TW3, INSERT/SST+8 

The named debug functions are terminated and named inser- 
tions are deleted (and the original contents of the affected 
core locations are restored). 

DISPLAY Control Message 

This control message allows the immediate display of the 
specified locations. It has the form 



ADISPLAY yN^/nyV^^n^,w^n^, 



where the wj define the symbolic locations at which the dis- 
plays are to begin, and the nj indicate the decimal number 
of words that are to be displayed. 

SYMTAB Control Message 

This message causes a dump of the resident symbol table. It 
has the form 

ASYMTAB 

RENTAB Control Message 

This message causes a dump of the reentrance chain. It has 
the form 

ARENTAB 

LEAVE Control Message 

This message causes the debug program to be exited and a 
return to MONITOR to be executed. It has the form 

ALEAVE 

SYSTEM POSTMORTEM DUMP PROGRAM 

An entry is provided in the executive to allow the user to 
obtain a postmortem dump of memory. The dump program is 
maintained on disc as a separate processor and is called with 
arguments specifying the extent and type of dump desired. 

When the dump program is called, it writes a section of mem- 
ory onto a disc file and loads itself into the vacated area. All 
registersaresavedand the dump is written on the LO device. 

Access to the dump program is via a DUMP message. Argu- 
ments may be provided to specify the first and last locations 
of an area to be dumped. If the required arguments are not 
provided, all of memory will be dumped. The DUMP mes- 
sage has the form 

ADUMP START, END 

Where START is the first location and END is the last loca- 
tion to be dumped. 



7. OPERATOR ACTIONS 



MONITOR communicates its needs for operator actions via 
the system console typewriter. Operator responses to the 
PAUSE message and calls to the system pause routine are 
discussed in "Operator Control Messages", Section 2. 
The calling sequences for the pause (R\PAWS), abort 
(R\ABRT), and system exit (R\EXIT) routines are given in 
Section 8. 



Toinitiatea key-in on the 9300 Computer, the operator first 
presses console button 32 (this is not applicable to 900 Series 
Computers). To start the key- in message on either 900 Series or 
9300 Computers, theoperatormust typea"A"as the first char- 
acter. MONITOR responds by doing a carriage return and typ- 
ing a second "/^" . The operator then keys in the remainder of 
the message and terminates by means of a carriage return. 



17 



8. MONITOR INTERFACES 



I/O OPERATIONS 

To perform an I/O operation, MONITOR must- know the de- 
scription of the basic EOM as well as other pertinent data. 
The File Description Table (FDT), an area provided by the 
user in his program, contains this information needed by 
MONITOR. The arrangement of an FDT is shown below: 

File Description Table 



Word 1 


File status; end address +1 


2 


Origin of record 


3 


Maximum word count 


4 


Device control EOM 


5 


I/O format control 


6 


Address of File Control Block 


7 


Address of end-action routine 



word!, bit Set = 1 if lOPS is using this FDT. 

bit 1 Set = 1 if an error occurred during 

the operation. 

bit 2 Set = 1 if an end-of-file was detected. 

bit 3 Set =1 if an end-of-tape or end-of- 

disc-file was detected. 

bit 4 Set = 1 if a beg inning- of- tape was 

detected. 

bit 5 Set = ] if an attempt to write on a 

file- protected tape occurred. 

bit 6 Set = 1 if I/O request cannot be 

honored. 

bits 7-8 Not used. 

bits 10-23*^ Contain the address+1 of the last 
word transmitted. 

word 2, bits 10-23 Contain the address of the origin of 
the record to be transmitted. 

word 3, bit If set 1 by calling routine, lOPS 

will return with bit 6 in word 1 set 
to 1 whenever I/O request cannot 
be honored. 

bits 10-23 Contain the maximum number of words 
to be transmitted. 



word 4, bits 0-12 Not used. 

bit 13 Set = 1, start with leader (paper tape 

only). 

Set = 0, do not start with leader. 



bit 14 Set = 1, transmit in binary mode. 

Set = 0, transmit in BCD mode, 
bits 15-16 Specify number of characters/word: 

Set = 0, 1 char/word. 

Set = 1, 2 char/word. 

Set = 2, 3 char/word. 

Set = 3, 4 char/word. 

word 5 may contain any of the following, depending on the 
device and operation: 

a. For magnetic tape spacing operations, this word will 
contain the number of records to be spaced. The 
number must be positive if forward, and negative 

if backward spacing is desired. 

b. For typewriter and paper tape operations, a stop 
character must be specified in bits 18-23. 

c. For random-access disc storage operations, a rela- 
tive sector address must be specified in bits 13-23. 

d. For printer operations, a carriage control character 
may be specified in bits 18-23 (see opcodes 60 
and 61). 

e. For scanning, must contain the appropriate 4 char- 
acters. 

word 6, bits 10-23 Contain the address of the FCB for 

the file being used (i.e., a reference 
to the FCB which will be satisfied at 
load time). 

word 7, bits 10-23 Contain the address of the user's end- 
action routine, if required (if no end- 
action is required, this word must be 
zero) 

The File Control Block (FCB) referenced in word 6 of an FDT 
has the arrangement shown below. An FCB for any device 
except discs and drums consists of words 1 and 2 only. Six 
words are required for disc files. 



File Control Block 



Word 1 
2 
3 
4 
5 
6 



Channel and unit designation 



Flags and driver pointer 



First sector address 



Last sector address 



Current sector address 



Current record address 



Bits 9-23 for SDS 9300 Computer. 
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word 1, bits 1,6, 17 Channel designation, 
bits 19-23 Unit designation. 

word 2, bit Not used. 

bit 1 Set = 1 if device may be accessed 

by batch programs. 

bit 2 Set = 1 if device is reserved for 

real-time programs. 

bit 3 Set = 1 if last use of device was by 

batch programs. 

Set = if last use of device was by 
real-time program. 

bit 4 Set = 1 if last operation on device 

was a rewind. 

bit 5 Set = 1 if device is unbuffered 

printer or a Model 9158 punch unit. 

bit 6 Set = 1 if device is random access 

disc file. 

Set = if device is sequential disc 
file. 

bits 7-18 Not used. 

bits 19-23 Index value (pointer) of subroutine 
entry for this device in I/O table. 



words, bits 9-23 First sector address, 

word 4, bits 9-23 Last sector address, 

word 5, bits 9-23 Current sector address, 

word 6, bits 17-23 Current record address . 



file area 



pointers 



Note that the format of the first FCB word is identical to 
that for records on magnetic tape and other units. 

I/O MONITORING 

The I/O processor, R\IOPS, is a reentrant program having 
a section of its temporary storage block reserved for each 
channel connected to the system. When R\lOPS is entered, 
the channel number is computed. A channel-active test is 
then made to determine if I/O operations may continue for 
the current request. When the required channel is not busy, 
general data (such as unit number, POT word, and the sec- 
ond EOM instruction) are calculated and saved in the temp 
block for that channel. The type of operation and device 
are determined, and a branch is made to the appropriate 
I/O device subroutine. 

The device subroutine determines whether or not the device 
is ready, and sets up the basic I/O instruction that will be 
used for the operation. All such instructions are stored in 
the R\IOPS temp block for the required channel. The de- 
vice subroutine issues Instructions that start the interlaced 



operation, and an interrupt subroutine is connected to the 
I/O interrupt submonitor to process the termination interrupt. 

When the transmission is terminated, the I/O interrupt sub- 
routine is entered and a check for error conditions is made. 
The interrupt subroutine is device-oriented and may cause 
some l/O operations to be done. When the requested I/O 
has been completed and all error flags have been set as re- 
quired, the interrupt subroutine returns to the I/O interrupt 
submonitor which then enters the user's end-action routine, 
if specified. Upon return from the end-action routine, the 
operation is completed and control is returned to the point 
of interrupt. 

The I/O processor monitors all input from the device assigned 
as the control message (C) file, and intercepts all A control 
messages. When such a message occurs in this file, the I/O 
routines set the end-of-file indicator in the user's FDT and 
return. If another attempt is made to read this, the job is 
aborted. 

Output data written on the listing -output (LO) file is also 
monitored. A line count is kept and the operation code is 
examined for each call on LO. 

Page ejects on the LO device occur at the maximum line 
count; and title line, data, and page numbers are output, 
followed by the user's line. This service is not done for 
onv file other than the LO file, evan though other files 
may be assigned to the same device as LO. 

I/O PROGRAMMING 

MONITOR uses its I/O processor to perform input/output 
operations. Via the I/O processor, MONITOR can perform 
one operation for each unit used by the user's program. Op- 
erations fordifferent channels run simultaneously; operations 
for the same channel run in the order requested. With each 
input/output operation there is an associated FDT. This 
FDT is set active as the input/output operation is requested, 
and is reset to inactive when the operation is completed. 

The following devices are serviced by the I/O processor: 

1. Card reader/punch 

2. Paper tape reader/punch 

3. Magnetic tape 

4. Line printer 

5. RAD File 

6. Typewriter 

The I/O processor contains a single entry point for I/O op- 
erations. Linkage with this entry is via a standard calling 
sequence with one argument word. The calling sequence is: 

BRM R\lOPS 
PZE 1 
OP LFDT 



Relative to the beginning of the sector block. 
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where OP is one of the following octal operation codes in 
bits 3-8: 

OP = On Read one record. For magnetic tape or 

RAD File operations, n (input mode speci- 
fication) is disregarded. For paper tape 
and typewriter operations, n may be a 
value from through 7. 

OP = 20 Scan forward, to record identifier speci- 

fied in word 5 of FDT. 

OP - 21 Scan backward to record identifier speci- 

fied in word 5 of FDT. 

OP = 30 Space i records (where i, the record count, 

is specified in word 5 of the FDT). Ap- 
plicable to magnetic tape or sequential 
RAD File. 

OP = 31 Write end-of-file. Applicable to mag- 

netic tape or sequential RAD File. 

OP = 32 Rewind. Applicable to magnetic tape or 

sequential RAD File. 

OP = 33 Write end-of-file and rewind. Applica- 

ble to magnetic tape or sequential RAD 
File. 

OP = 4n Write one record. For magnetic tape or 

RAD File operations, n is disregarded. 
For paper tape and typewriter operations, 
n (mode) may be either or 1 . 

OP - 5n Write one record. This is a printer oper- 

ation that specifies a skip to channel n 
before printing. 

OP = 60 Write one record. This Is a printer op- 

eration specifying that the carriage con- 
trol character for this record is in the 
fifth word of the FDT. 

OP = 61 Write one record. This is a printer oper- 

ation specifying that the carriage control 
character for this record is the first char- 
acter of the line to be printed. The car- 
riage control character is replaced by 
060 (blank) before the line is printed. 

OP = 7n Write one record. This is a printer oper- 

ation specifying that n lines (maximum of 
7) are to be upspaced before printing. 

TYPEWRITER/PAPER TAPE OPERATION CODES 

The following opcodes are used to specify I/O modes for 
paper tape and typewriter operations in a user's program. 

OP is 00 

This specifies a BCD input mode in which transmission is im- 
mediately terminated on encountering a stop code, exhaust- 
ing the word count, or encountering a gap on paper tape. 

OP is 02 

This specifies a BCD input mode in which transmission is im- 
mediately terminated only on encountering a stop code or 



exhausting the word count. If a gap is encountered on paper 
tape, it is ignored; the tape is spaced past the blank area 
and transmission resumes. 

OP is 04 

This specifies a BCD input mode in which transmission is im- 
mediately terminated on encountering a stop code, exhaust- 
ing the word count, or encountering a gap on paper tape. If 
the maximum word count is exhausted, paper tape is spaced 
to the next gap. 

OP is 06 

This specifies a BCD input mode in which transmission Is im- 
mediately terminated on encountering a stop code. Any gaps 
on paper tape, encountered before the word count Is exhaust- 
ed, are ignored. If the maximum word count is exhausted, 
paper tape is spaced to the next gap. 

OP is 01 

This specifies a binary input mode in which transmission is 
immediately terminated on exhausting the word count or en- 
countering a gap on paper tape. 

OP is 03 

This specifies a binary Input mode In which transmission is 
immediately terminated on exhausting the word count. If a 
gap is encountered on paper tape, it is ignored; the tape is 
spaced past the blank area and transmission resumes. 

OP is 05 

This specifies a binary input mode in which transmission Is 
immediately terminated on encountering a gap on paper tape 
or exhausting the word count. If the maximum word count is 
exhausted, paper tape Is spaced to the next gap. 

OP is 07 

This specifies a binary input mode. Any gaps on paper tape, 
encountered before the word count is exhausted, are ignored. 
If the maximum word count is exhausted, paper tape is 
spaced to the next gap. 

OP is 40 

This specifies a BCD output mode in which transmission is im- 
mediately terminated on encountering a stop code or exhaust- 
ing the word count. 

OP is 41 



This specifies a binary output mode in which transmission is 
immediately terminated when the word count is exhausted. 

Table of I/O Modes 

The options implemented in the various paper tape and type- 
writer I/O modes are summarized in the following table. 



Paper Tape and Typewriter I/O Modes 



Octal 








Delete? 




Change 


Stop 


Move 


Ignore 


OP 


Mode 


I/O 


Pad? 


(077) 


This 


to This 


Code? 


to Gap 


Gap 


00 


BCD 




060 


Yes 


012 


060 


Yes 


No 


No 


01 


Bin. 




00 


No 


~ 


~ 


No 


No 


No 


02 


BCD 




060 


Yes 


012 


060 


Yes 


No 


Yes 


03 


Bin. 




00 


No 


~ 


~ 


No 


No 


Yes 


04 


BCD 




060 


Yes 


012 


060 


Yes 


Yes 


No 


05 


Bin. 




00 


No 


~ 


— 


No 


Yes 


No 


06 


BCD 




060 


Yes 


012 


060 


Yes 


Yes 


Yes 


07 


Bin. 




00 


No 


~ 


~ 


No 


Yes 


Yes 


40 


BCD 


O 


No 


No 


060 


012 


Yes 


No 


No 


41 


Bin. 


o 


No 


No 


~ 


~ 


No 


No 


No 



MAGNETIC TAPE OPERATIONS 

READING 

A record from the magnetic tape specified in the FCB re- 
ferred to in the sixth word of the FDT is read into memory. 
The starting address is specified in the second word of the 
FDT. Reading continues until the end-of-record is reached 
or until the word count v"Oru3, FDT) is reduced to zero. In 
both cases, the tape is positioned in the gap following the 
record read. If an error has occurred, the error flag bit in 
the FDT status word will be set to 1. The end-of-file, 
beginning-of-tape, and end-of-tape error flags in the FDT 
status word are set if those conditions are encountered. 

WRITING 

Before each write operation is attempted, the tape is tested 
for file-protect. If a file-protect is detected, the file-protect 
bit in the FDT status word is set and control is returned to 
the user's program. 

One physical record, of the length specified by the word 
count in the FDT, is written. If an error occurs, and the 
write is retried and is still unsuccessful, the error flag in 
the FDT status word is set. The tape stops after the last 
write attempt. 

If the end-of-tape indicator is set during the write opera- 
tion, the end-of-tape flag in the FDT status word is set. 

SPACING 

Spacing is accomplished by using the tape scan operation 
in the 4-characters-per-word mode. Spacing may be either 
forward or backward, as specified in the fifth word of the 
FDT. Spacing is terminated by an end-of-tape, end-of- 
file or beginning-of-tape signal. 

SCANNING 

The specified file will be scanned for a record identifier 
identical to the key word specified in word 5 of the FDT. 



For a forward scan, the identifier will be the last 4 charac- 
ters of each record. If the operation is a reverse scan, the 
identifier will be the first 4 characters of each record, in 
reverse order. 

If an end-of-file, beginning-of-tape, or end-of-tape con- 
dition occurs, the scan will terminate and the appropriate 
flag will be set in the FDT. 

WRITE END-OF-FILE 

The tape is tested for file-protect. If a file-protect is de- 
tected, the file-protect bit in the FDT status word is set, 
otherwise, an end-of-file is written. If an error occurs, the 
tape is repositioned and the operation retried. 

CARD READER/PUNCH OPERATIONS 

READING 

One record is read from the device specified in the FDT. 
If the number of words specified in the table is less than the 
number of words in the record, the remaining words are lost. 
If an error occurs or an end-of-file condition is detected, 
appropriate flags are set in the status word of the FDT. 

PUNCHING 

One record is punched on the device specified in the FDT. 
If an error occurs, an error flag is set in the status word of 
the FDT. 

ERRORS 

If a feed check error has occurred, the ending address in 
word 1 of the FDT will be equal to the starting address. If 
a validity check error has occurred, the ending address in 
word 1 of the FDT will not be equal to the starting address. 
This difference allows the program to determine which type 
of error has occurred. 
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LINE PRINTER OPERATIONS 

PRINTING 

One record is printed on the line printer specified by the 
FDT. The format control is dependent on the value of the 
OP in the user's calling sequence. If the word count in 
the FDT specifies more than 132 characters, only the first 
132 will be printed. If the word count specifies zero words, 
the format control character will be interpreted, the re- 
quired format action taken, and control returned to the user. 

ERRORS 

A channel error will cause the error bit to be set in the sta- 
tus word of the FDT. 

CARRIAGE CONTROL 

The following tables list the carriage control characters 
which R\lOPS will accept. Table 1 gives the standard 
SDS format control characters which are specified in the 
FDT or in the first character position of the output record. 
If one of these characters is used, the mode of the I/O re- 
quest (FDT word 4, bit 14) must be binary (i.e., FDT word 
4, bit 14 = 1). If the mode of the I/O request is BCD, the 
carriage control character will be assumed to be a FORT- 
RAN character, as described in Table 2. 



Table 1, 



Carriage Format Control Characters 

Skip to format channel 
Skipto format channel 1 
Skip to format channel 2 
Skipto format channel 3 
Skipto format channel 4 
Skipto format channel 5 
Skipto format channel 6 
Skipto format channel 7 
Do not upspace before printing 
Upspace 1 line before printing 
Upspace 2 lines before printing 
Upspace 3 lines before printing 
Upspace 4 lines before printing 
Upspace 5 lines before printing 
Upspace 6 lines before printing 
Upspace? lines before printing 
Upspace 1 line before printing 



Table 2. FORTRAN Carriage Format Control Character 

00 Double space before printing 

01 1 Skip to top of form 

20 + Do not upspace before printing 

other Skip one line before printing 

PAPER TAPE AND TYPEWRITER OPERATIONS 

Paper tape and typewriter operations are performed in either 
the BCD or binary mode as described below. These modes 
specify the type of character testing to be performed by 
the I/O processor during data transmission. The user's 



00 





01 


1 


02 


2 


03 


3 


04 


4 


05 


5 


06 


6 


07 


7 


40 


- 


41 


J 


42 


K 


43 


L 


44 


M 


45 


N 


46 


O 


47 


P 


other 





program may also specify the termination conditions for the 
operation, by placing a stop-character code in word 5 of 
the FDT, prior to calling the I/O processor. 

The modes of operation, BCD and binary, are not hardware 
modes of operation, but only convenient names describing 
the options available (specified by I/O opcodes). 



BCD MODE 



Delete Character 



A BCD input operation will ignore any 077 (delete) codes 
read. 

Blank Replacement 

Either a 060 or a 012 will produce a blank space on a line 
printer. However, a typewriter will type a 060 code as a 
b and a 012 code as a space. In a BCD output operation, 
all 060 codes are converted to 012 codes. In a BCD input 
operation, all 012 codes are converted to 060 codes. 

Padding of Partial Words 

In a BCD input operation for which the number of characters 
read is not an integral multiple of the number of characters 
per word (specified in word 4 of the FDT), the last word is 
padded with trailing 060 codes. No equivalent option is 
provided for output operations, since output terminates on 
the transmission of a stop character. 

Stop Character 

In a BCD mode, encountering a character equal to the stop 
code causes transmission to be terminated when the process- 
ing of that character is completed. 



BINARY MODE 



Delete Character 



In a binary mode, the transmission of 077 code is handled in 
precisely the same way as any other code. 

Blank Replacement 

In a binary mode of transmission, no character replacement 
is done. 

Padding of Partial Words 

In a binary input operation for which the number of charac- 
ters read is not an integral multiple of the number of charac- 
ters per word, the last word is padded with trailing zeros, 
(No equivalent option is provided for output operations,) 

Stop Character 

In a binary mode of transmission, no stop character options 
exist, as no stop code is used. 
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DISC FILE OPERATIONS 

RANDOM-ACCESS OPERATIONS 



Reading 



Data can be read from disc storage files oy specifying a 
sector address in word 5 of the FDT. The file used must 
have been assigned to disc storage by an ASSIGN message 
and must have had a maximum file size specified. (When 
the file was assigned to disc storage, file sectors were allo- 
cated for it by MONITOR and its disc address was saved in 
the FCB.) The sector address specified in the FDT is treated 
as a relative address (i.e., relative to the beginning of the 
file). Words are read from the file, beginning at the speci- 
fied sector and continuing until the word count is reduced 
to zero. A maximum word count of 4096 may be specified 
in word 3 of the FDT- 

Writing 

Data can be written on disc storage files by using the word 
count and sector address specified in the FDT. The word 
count is checked to ensure that the data to be written does 
not exceed the limits of the file specified. 

Errors 

If a channel error occurs, the error bit of the status word 
of the FDT is set to 1. 



If an attempt is made to transmit data beyond the limits of 
the specified file, only data within the specified file is 
transmitted and the end-of-dlsc-file bit in the status word 
of the FDT is set to 1. 



SEQUENTIAL OPERATIONS 

Files assigned to disc storage may be treated in much the 
same manner as sequential magnetic tape files. That is, 
they can be manipulated with the same I/O commands as 
magnetic tape files. Each disc operation is similar to a 
corresponding magnetic tape operation. Sequential disc 
files are manipulated by the disc I/O subroutine by arrang- 
ing them into chained sector blocks and maintaining these 
blocks by the use of pointers. The pointers for each file 
are stored in the FCB. 

As data is written on a file and new blocks of sectors are 
needed to contain it, new blocks are obtained from a disc 
sector map and are added to the chain. Within each sec- 
tor block are record control words that depict the individ- 
ual records written on the file in that block. These record 
control words are used by the disc I/O subroutine in man- 
ipulating and maintaining disc files. 



purged and its sector blocks are reallocated. The empty- 
sector pool is always purged at the end of a job. 

The format of the sector block record control words is given 
below. 

Sector Block Record Control Words 



word 1 bits 9-23 Previous sector 

address 

word 2 bits 9-23 Next sector 

address 

word 3 bits 0- 1 1 Previous record 

length 
bits 12-23 Current record 
length = n 

word 4 bits 0-23 First word of 

record 

3+n bits 0-23 nth word of 

record 

3+n+l bits 0-11 Previous record 
length = n 
bits 12-23 Current record 
length - m 



I sector control 
words 



logical-record 
control word 



logical -record 
control word 



DISC STORAGE SECTOR MAP 



A disc storage sector map is ma 
use in allocating disc storage, 
each sector block on disc. The 
memory each time that a sector 
is also maintained and updated 
cessor for each file reserved by 
On completion of a batch job, 
ory is initialized by overlaying 



intained in core memory, for 
The map contains a bit for 
sector map is updated in core 
block is allocated. The map 
on disc by the assign pro- 
an ASSIGN control message, 
the sector map in core mem- 
it with the disc map. 



In the following description of map searching, a sector 
block is referred to as a sector. 

DISC SECTOR MAP SEARCH 

The disc sector map search routine performs the function of 
searching the disc sector map in core, obtaining the address 
of the available sectors, and allocating these sectors by set- 
ting map bits. There are two entry points to the routine. 

Entry point R\SECT is used when a single sector block (sec- 
tors are always allocated in a block of 4 sectors) is to be 
allocated. The calling sequence for R\SECT is: 

BRM R\SECT 
PZE 

No arguments are specified and the address of the allocated 
sector is returned in the A register. 



When a file is released during the processing of a job (not 

^t- 4-U^ ^^^ ^f ^ :^U^ 4.U^ ^^^4.^..^ ^ll^^»4-»^ fr^v 4-Uo CIn r^va 

placed in an empty-sector pool. If, at some later time, 
no other sectors are available the empty-sector pool is 



R#»,~^r-,Jo rv,^,. 



.r-^r-.r UU^I,, 






-r^vA 



control word is not always the first word after the sector 
control words. 
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The second entry point, R\SCTS, isused when a block of sectors 
is to be allocated. The calling sequence for R\SCTS is: 

BRM R\SCTS 

PZE 3 

PZE SIZE 

PZE FSTSCT 

PZE LSTSCT 

where: 

SIZE is a cell containing the size, in words, of the 

block of storage 

FSTSCT is a cell containing the disc address of the 
first sector in the allocated block. 

LSTSCT is a cell containing the disc address of the 
last sector in the allocated block. 

Error Conditions 

If the search program is unable to locate any available sec- 
tors, a test is made of the empty-sector pool, which con- 
tains all sectors that have been allocated and released during 
a job. If there are sectors in the pool, they are returned to 
the sector map and reallocated. If the empty-sector pool 
does not contain any sectors, the following options apply: 

1. If current sectors were to be allocated too batch job, the 
job is aborted and a message typed to inform the operator. 

2. If a real-time program is operating and a batch job is 
in memory (not swapped out), the batch job is aborted 
and a message typed. When a batch job is aborted dur- 
ing real-time processing, the batch symbol table is 
searched for the FCBs and the sectors allocated for those 
files are released. 

3. If a real-time program is operating and a batch job does 
not exist in memory, the current interrupt level is 
cleared and the previous interrupt program continued. 
A message is typed describing the reason for clearing 
the interrupt and the interrupt level. 

MONITOR SUBROUTINES 

MONITOR subroutines of general interest are discussed here, 
as an aid in understanding the basic control functions per- 
formed by MONITOR. Note that the user does not normally 
participate in the performance of such functions, aside from 
providing the necessary control messages (via control cards 
or typewriter). 

SYSTEM PAUSE ROUTINE 

The calling sequence for the pause routine is as follows: 



BRM R\PAWS 

PZE n 

PZE MSG 

PZE RETRY 

PZE ERROR 



MSG 



PZE 
TEXT 



size 

m, message 



For 1 < n < 3 
(required) 
(optional) 
(optional) 



Message length, in words 
m = size*4 



Note that RETRY and ERROR are optional return points. If 
the ERROR exit is desired, RETRY must also be specified (the 
RETRY exit could be a dummy). An unconditional branch to 
the optional exits is executed when the exit is taken. 

Routine R\PAWS types the specified message and permissible 
operator actions according to the exit<; defined by the call. 
The typeout is in the following format: 

♦PAUSE* TYPE AABORT; AGO; ARETRY; AERROR 

Note that if the ERROR (or RETRY and ERROR) exit was not 
defined in the call to R\PAWS, the AERROR (or the ARETRY, 
AERROR) option would not appear in the typeout, 

SYSTEM ABORT ROUTINE 

The calling sequence for the abort routine is as follows: 



BRM 
PZE 
PZE 



R\ABRT 



MSG 



MSG PZE size Message length, in words 

TEXT m, message m = size*4 

If R\ABRT is called from a batch job, the routine will cause 
the following message to be output: 

*JOB ABORTED* 

However, if the abort routine is called from a resident real- 
time routine, the message 

*INTERRUPT ABORTED* 

will be output and MONITOR will return to the next- lower 
active interrupt level (including the "zero" level, if no in- 
terrupts are active). 

SYSTEM EXIT ROUTINE 

The calling sequence for the system exit routine is as follows: 

BRM R\EXIT 
PZE 

This routine is the normal exit from a batch job, and may not 
be called by a resident real-time program. 



CONTROL MESSAGE SCAN ROUTINE 



The control message scan routine, R\SCAN, is used to scan 
the specification fields of a control message. It returns each 
field delimiter and the character string preceding the delim- 
iter, as well as the transfer address associated with the de- 
limiter. The calling sequence for R\SCAN is on the following 
page. 
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DElIM 
TABLE 



NO.CHAR 
STRING 

where 

maxchar 



BRM 
PZE 
PZE 

FORM 

PZE 

PZE 

DELIM 

DELIM 

DELIM 

PZE 

RES 



R\SCAN 

1 

TABLE 



6,18 
maxchar 
n 

'di',addri 
'do'/ addro 



•d,',addr„ 




The maximum number of characters 
allowable in the string, (i.e., 4*m) 

n = The number of delimiter entries. 

dj = Delimitercharacter. 

addrj = The transfer address associated with the 

delimiter. 

R\SCAN will return the field delimiter (one of the set spec- 
ified in the delimiter table) in bits - 5 of the A register, 
the associated transfer address in the index register (900 
Series; XI on a 9300), the number of characters in the string 
in NO.CHAR, and the character string itself, left-justified 
with trailing blanks, in STRING. 

If a delimiter of the specified set cannot be found in the 
control message, R\SCAN will set bit of NO.CHAR and 
will reset bits 1 - 23, the A register, and the index register. 
If the character string length exceeds maxchar, but a delim- 
iter is found, R\SCAN will return with normal settings, ex- 
cept that bit of NO.CHAR will be set. 

RESIDENT SYMBOL TABLE SEARCH ROUTINE 

A call on R\RSTS causes the resident symbol table to be 
searched for the specified symbol. The resident symbol 
table is composed of external definitions of all programs 
currently in memory and is broken into two parts; (1) MON- 
ITOR and batch program external references, and (2) MON- 
ITOR and resident program external references. Conse- 
quently, except for symbolic file references, symbols used 
by batch and resident programs will not conflict. 

Each symbol table entry has the following format: 




Address of previous 
symbol table entry 



8-character symbol (BCD format) 



Code 



Code 




Location referenced by symbol 



Location referenced by symbol 



Word 1 
Word 2 
Word 3 
Word 4 
Word 5^ 



J 4 5 /by 

4- 

'Optional; see code 12 below. 
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Code 






(octal) 




Reference 


00 


= 


Unused. 


01 


= 


Unused. 


02 


= 


Reference to a non-disc (or drum)FCB. 



03 



04-07 
10 
11 
12 



13 

14-17 

LO 


1 

FCB 



1 



Reference to a system file FCB, A system file 
cannot be reassigned, nor can another file be 
assigned to it. 

Unused, 

External definition reference. 

Unused. 

Reference to a disc (or drum) FCB. This symbol 
table entry will consist of 5 words. If this file 
is reassigned, word 4 will be saved in word 5, 
and the new assignment will be reflected in 
word 4. 

Same as code 03, but this file will be unde- 
fined in the magnetic tape version of the sys- 
tem. 

Unused. 



This is not a reference to the LO file FCB, 
This is a reference to the LO file FCB, 



= This is not a reference to an FCB, 
= This is a reference to an FCB. 



The calling sequence for the symbol table search routine is 



BRM 
PZE 
PZE 



R\RSTS 

1 

STRING 



STRING TEXT 8, symbol 
PZE K 



^here 



K = 1, search batch program symbol table. 

2, search resident program symbol table. 

3, search both batch and resident program symbol 
tables. 

When R\RSTS finds the symbol defined by STRING, the lo- 
cation defined by the symbol will be returned in the A reg- 
ister (bits 9-23). The location of the symbol table entry wil 
be returned in the index register (900 Series; XI for 9300), 
If the symbol cannot be found in the symbol table, bit of 
the A register will be set. 
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If K specifies that both symbol tables are to be searched, the 
resident program symbol table will be searched first. 

SYSTEM BCD TO BINARY CONVERSION ROUTINE 

This program will convert a BCD string of numbers to a bin- 
ary value. If the string contains a decimal point, it will be 
considered to be a single-precision floating-point value. If 
the string begins with a zero (and contains no decimal point), 
it will be considered to be an octal value. 

The calling sequence for R\CNVT is 



NO.CHAR 
STRING 



BRM 
PZE 
PZE 

PZE 
TEXT 



R\CNVT 

1 

NO.CHAR 



m, string 



where 



n = Number of characters to be used, 
m = Integer ((n+4-l)/4). 

Integer decimal and octal values will be returned in the A 
register, and floating-point values will be returned in the 
A and B registers. Values which are not representable, due 
to excess magnitude, will result in the A and B registers 
being set to maximum or minimum values (dependent on the 
sign of the value). Illegal strings will cause the maximum 
settings. 

RESIDENT LOADER 

Resident Loader Control Routine 

All programs are loaded under the direction of the resident 
loader control routine, which informs the semiabsolute 
loader of load locations and library files required and also 
generates the implicit call linkage table. Resident loader 
control is entered via the calling sequence 

BRM R\LOAD 

PZE system file name 

PZE system program name 

PZE load location, tag 

system file name is one of the following system files: 

1. R\PROC the processor file 

2. R\0VRL the overlay file (includes user's routines) 

3. R\PRIL the primary library file 

4. R\SECL the secondary library file (includes user's 

routines) 

system is the address of the first of two consecutive 
program words containing the name of a program that is 
name to be loaded and that can be found in the file 

specified by file name. 



load is the address of a word containing the location 

location at which the program is to be loaded. The value 

of tag determines whether or not the program is 

entered following loading. 

tog = 0: the program is not entered and control returns 
to the caller. 

tog = 1: the program is entered at the location speci- 
fied by program name. 

If the program entered returns control to resident loader con- 
trol, resident loader control returns to its caller. 

Semiabsolute Loader 

The semiabsolute loader performs all program loading func- 
tions for the system. Given the program and file names as 
arguments, it searches the file dictionary to obtain the pro- 
gram's disc address. It then reads the program directly into 
the memory location into which it is to be loaded. 

The seimabsolute loader calling sequence is 

BRM R\SALD 

PZE file name 

PZE program name 

PZE load location 

file name contains the name of the file in which the pro- 
gram to be loaded can be found. 

program is the address of the first of two words which 
name contain the name of the program to be loaded. 

load contains the address at which the program is 

location to be loaded. 



Implicit Call Processor 

The implicit call processor is entered as a result of attempt- 
ing to execute an instruction that referenced an undefined 
external symbol at load time. When such an unsatisfied 
reference exists at load time, the resident loader control 
routine makes an implicit call link in dynamic storage entry. 
It is through such an entry that the implicit call processor is 
entered. 

Upon entry, the implicit call processor searches the resident 
symbol table for the required symbol. This is done in case 
the symbol has been defined by a load subsequent to the link 
entry being generated. If the symbol table is not in resi- 
dence, a search is made of a system file, either overlay, 
processor, or secondary library, depending on the type of 
program being executed, and the program containing the 
required symbol is loaded. After loading, the value of the 
required symbol is merged into the replaced instruction with- 
in the implicit call link entry and the instruction is executed 
interpretively. 
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The implicit call link entry is 

REFi BRM CALLi Original reference replaced by 

this instruction 

CALLi PZE First word of link entry 

BRM R\IMP Call to implicit call processor 

TEXT 8, name 8-character name of referenced 
item 



instruction 
Manual Loading 



instruction originally at REFi 



The user may cause a program to be loaded, without exe- 
cution, by referring to it as the operand of an NOP instruc- 
tion. An example is given below. 

NOP TABLES 

The above example would result in the generation of the 
following: 

BRM IMPi 



IMPi PZE 

BRM R\IMP 
TEXT 8, TABLES 
NOP 

STANDARD CALLING/RECEIVING SEQUENCES 

900 SERIES COMPUTERS 

The calling/receiving sequences for the SDS 900 Series use 
operation code bits to determine the data type of the argu- 
ments. These data type codes are derived as follows: 





Receivi 


ng Sequences Only 




Type 


Normal 


Octal 


Protected 


Octal 


(Real, in- 


ANY 


007 


ANYP 


047 


teger, or 










double- 










precision) 










(ANY plus 


ALL 


017 


ALLP 


057 


complex) 










(ALL plus 


EVRY 


0S7 


EVRP 


077 


logical) 










(Variable 


VARG 


771 






number of 










arguments) 











The above octal operation codes are composed of bits set to 
1 according to the following conventions: 

bit 3 = 1: protected (calling — cannot be stored into; 
receiving— will store into) 



bit 4= 1: 


logical 


bit 5= 1: 


complex 


bit 6= 1: 


double- precision 


bit 7= 1: 


real 


bit 8=1: 


integer 



Data Type Codes 





Calling or 


Receiving 


Sequences 




Type 


Normal 


Octal 


Protected 


Octal 


Integer 


INTO 


001 


INTP 


041 


Real 


SNGL 


002 


SNGP 


042 


Double- 


DOUB 


004 


DBLP 


044 


precision 










Complex 


CMPX 


010 


CPXP 


050 


Logical 


LOGL 


020 


LGLP 


060 


(Labels, 


PZE 


000 


PZEP 


040 


suDprogram 










identifiers. 










etc.) 











Calling Seq 


jence. The standard calling sequence is 


BRM 


subprogram 


PZE 


n 


type 


arg^ 


type 


arg2 


type 


argg 


type 


org 
n 


where n specifies the number of calling arguments, 
and the argj are the addresses of the calling argu- 
ments. The "type" operation codes indicate the data 
type, if any, of the calling arguments. 
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Receiving Sequences 


. The standard receiving sequence is 




entry 




PZE 
BRM 
PZE 




9SETUP 
NO. ARGS 


Entry point 

Call to set up n arguments 








BRR 


entry 


Exit (RETURN) 




NO. ARGS 
ARGl 




PZE 
type 


n 



n = number of receiving arguments 
Calling argument 
addresses moved 
to these locations 
by 9SETUP 




ARGn 




type 





Local variables, 
temps, etc. 




The above receiv' 


ng 


sequence 


is modified si 


ghtly for routines that expect varying numbers of arguments. 


as in 


entry 




PZE 
BRM 
PZE 

BRR 




9SETUP 
NO. ARGS 

entry 


Entry point 

Call to set up a variable number of arguments 




NO. ARGS 
ARGl 
ARG2 
ARGS 




VARG 
type 
type 
type 


n 





n = number of fixed arguments 
Fixed arguments 




ARGn 
ARGv 




type 
type 
PZE 



*,X1 

m 


Variable arguments 

m = number of variable arguments 




m 




PZE 










Receiving 


Sequences 


for PROTECTED Routines 


. All FORTRAN routines designated as PROTECTED have the receiving 


sequence 










entry 




PZE 
DIR 



0,2 


Entry point 






BRM 


R\PROT 


Protection routine 






PZE 


NO. ARGS 








BRM 


R\UNPT 


Unprotect routine 






BRR 


entry 


- 
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NO. ARCS 


type 


n 


(Either PZE or VARG) 


ARGl 


type 







ARG2 


type 







ARG3 


type 
etc. 








Receiving Sequences for Reentrant Routines . FORTRAN routines that have been declared to be RECURSIVE, and reen- 
trant assembly- language programs, have the receiving sequence 



entry 



PZE 

DIR 

BRM 

PZE 

PZE 



BRR 



TEMPS 


PZE 


LAST 


PZE 


RETURN 


PZE 


NO, ARGS 


type 


ARGl 


type 


ARG2 


type 


ARGS 


type 



END 



Entry point 

0,2 

R\RENT Reentrance monitor 

TEMPS Temp block 

NO. ARGS 



RETURN 



END-$ + l Size of temp block 



n (Either PZE or VARG) 




Fixed and/or variable arguments, 

local variables, and temps 

(Last temp cell) 



The CONNECT Statement. 


The 


FORTRAN IV CONNECT statement generates code having the same effect as the fol lowing: 


FORTRAN statement 










CONNECT (40,SUB(ARG1,ARG2,ARG3)) 


Generated code: 












BRM 




R\CNCT 


CONNECT routine 




PZE 




2 






PZE 




040 






PZE 




entry 






BRU 




NEXT 




entry 


PZE 











BRM 




SUB 


CONNECTED routine 




PZE 




3 






type 




ARGl 






type 




ARG2 






type 




ARGS 






BRR 




entry 




NEXT 











29 



9300 Computer 

A reference to a subprogram by a source program causes 
the compiler to generate a calling sequence to the sub- 
program. Also, some subprograms are called implicitly by 
the source program. In either case, the referenced sub- 
program has a receiving sequence that facilitates the ex- 
change of argument addresses between the calling statement 
and the subprogram- Such sequences are of three types: 
standard, nonstandard, and special. 

Standard Calling Sequence. The standard calling sequence 
is 



BRM 
PZE 
type 
type 
type 



subprogram 

n 

argi 

arg2 

argg 



n = the number of 
calling arguments 



type argn 

Standard Receiving Sequence. The standard receiving se- 
quence is 

entry 



PZE 
BRM 
PZE 
type 
type 





9SETUPN 

n 







n = the number of 
receiving 
arguments 



Standard Receiving Sequence with Conversion . It is often 
desirable to allow a subprogram to accept an argument of 
any of several types (e.g., any of the numeric, but not logi- 
cal, forms). However, because it is practical to write the 
subprogram to process only one type, a procedure is needed 
to perform the desired conversion. An example is given below. 



Cal 



iing 

BRM 
PZE 
SNGL 
LOGL 

Receiving: 
SPROG 



for N = 2: 



SPROG 
2 

argi 
arg2 



PZE 

BRM 

PZE 

ANY 

LOGL 

DOUB 





9SETUPNC 

2 





ITEMP 



LOGL 2TEMP 



The PZE 2 defines 
two receiving 
arguments and two 
conversion items 



The last two arguments of the above receiving sequence 
specify the types to which the corresponding calling argu- 
ments are to be converted Cind the locations into which the 
converted arguments are to be stored. 



Standard Receiving Sequence for a Variable Number of Ar- 
guments . When it is desirable to write a subroutine capable 
of handling a variable number of arguments, the receiving 
sequence must determine the number of arguments from the 
calling sequence and must transmit the argument address to 
the subprogram. An example Is given below. 

Calling 





BRM 


SPROG 




PZE 


5 




SNGL 


argi 




LOGL 


arg2 


EXTRA 


DOUB 


arg3 




DOUB 


arg4 




DOUB 


orgs 


Receiving: 






SPROG 


PZE 







BRM 


9SETUPV 




VARG 


2 




ANY 







LOGL 







DOUB 


*,X1 




STA 


LOCN 



LOCN 



PZE 



TheVARG 2 defines 
two fixed arguments 



VARG specifies the number of fixed arguments (even if 
n = 0), and ANY and LOGL are the type specifications for 
the fixed arguments. The following line (DOUB*, XI) is the 
type specification for the variable arguments; it is always 
indirect and is normally indexed, to facilitate access of the 
remaining arguments. The 9SETUPV subprogram will process 
the fixed argument specifications as usual, but will replace 
the operand of the variable type specification with the ad- 
dress of the last fixed specification inthe calling sequence 
(i.e., EXTRA- 1). The number of variable arguments is 
placed in LOCN^ Thus, for the above example, after 
9SETUPV has been executed the receiving sequence looks 
like 



SPROG 



PZE 







BRM 


9SETUPV 




VARG 


2 




SNGL 


arg^ 




LOGL 


arg2 




DOUB 


* EXTRA - 


1,X1 


STA 


LOCN 





LOCN PZE 3 

where org- means the effective address of argument i, 



The number of variable arguments may be zero. 
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Standard Calling/Receiving Sequences for No Arguments. 
The standard calling sequence for no arguments is 

BRM subprogram 

PZE 

The standard receiving sequence for no arguments is 

subprogram PZE 

BRM 9SETUP0 
PZE 

Nonstandard Calling/Receiving Sequences. The compiler 
generates a nonstandard sequence whenever only one argu- 
ment is required and the type of aigument required by the 
subprogram is known. An example of a nonstandard calling 
sequence is 



LDP 
BRM 



ARGUMENT 
9SIN 



A receiving sequence is not normally required; references 
such as 9SIN usually access the actual start of the subpro- 
gram. 

The argument supplied is always located in the "principal 
register." Each type of data has its own principal register: 



EXIT BRM R\SETDWN 

BRR ENTRY 

FIRST • local variables, and temps 

LAST PZE 

TEMPS PZE TEMPS-FIRST + 1 



Receiving Sequence for PROTECTED Subprograms 

The standard receiving sequence for PROTECTED subpro- 
grams is 



SENTRY 


PZE 






DIR 


M 




BRM 


R\SETUP 




PZE 


*TEMPS 

normal receiving sequence and 

program 


EXIT 


BRM 


r\enable 




BRR 


ENTRY 


FIRST 




local variables, and temps 


LAST 


PZE 





TEMPS 


PZE 


TEMPS-FIRST + 1 



Type 

Integer 
Real 



Principal Register 

A 
A,B 



Double-precision 8DBL (or 8DBL0, 8DBL1, or 
8DBL2) 



Complex 



Logical 



8CPX (or 8CPXR, 8CPXI, 
8CPX0, 8CPX1, 8CPX2, or 
8CPX3) 



Other (labels, etc.) A 



The CONNECT Statement 

The FORTRAN IV CONNECT statement generates code as 
described in Section 5. 



MONITOR LINKAGE CELL R\MACH 

R\AAACH indicates the type of CPU that MONITOR is being 
used with. Bit is set to a if the CPU is either a 910 or 
a 925, otherwise it is set to a 1. Bit 1 is set to a if the 
CPU is either a 910 or a 920, otherwise it is set to a 1 . This 
code is illustrated in the following table: 



Receiving Sequence for Reentrant Subprograms . 

The standard receiving sequence for reentrant subprograms 
is 

SENTRY PZE 

DIR *, 1 

BRM R\SETUP 

PZE TEMPS 



CPU 


BitO 


Bit 1 


910 








920 


1 





925 





1 


930 


1 


1 


9300 


1 


1 



Note that the codes for the 930 and 9300 Computers are 
identical. 
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9. SYSTEM UPDATE ROUTINE 



GENERAL DESCRIPTION 

The UPDATE processor's purpose is to update the basic sys- 
tem tape for use by the system-generator (SYSGEN). It 
also may be used to update any file of a similar format. 
There are three basic functions of file maintenance, namely: 

1. Replacement. 

2. Insertion. 

3. Deletion. 

Other functions that the UPDATE processor can perform are: 

1. File copying, 

2. Labeling an output file 

3. Rewinding a designated file or files. 

4. Writing an end-of-file on a designated file or files. 

5. Scanning a designated file for a given label. 

6. Skipping a designated file forward or reverse. 

UPDATE PROCESSOR CONTROL MESSAGES 

The UPDATE processor is a control-message oriented routine. 
UPDATE is initiated by one of the following control mes- 
sages: 

AUPDATE from, to[= uNBLOCKEd] 



AUPDATE 



to 



[- 



BLOCKED 1 
UNBLOCKED J 



where 
from 

to 



= a previously assigned symbolic file 
name, to be used as the input file. 

= a previously assigned symbolic file, 
to be used as the UPDATEd output 
file. 



BLOCKED = Output file will be blocked (£400 

UNBLOCKED 



words/block). 
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Output file will be unblocked (1 
card image/block). 



If neither BLOCKED nor UNBLOCKED are specified, 
BLOCKED is assumed. 

The UPDATE control message which defines "from" and "to" 
implies a file copy from "from" to "to" with possible up- 
dating from the "C" device. If the UPDATE control message 
defines only one parameter (i.e., "to"), the UPDATE pro- 
cedure is to copy from the "C" file to the "to" file. 

If the UPDATE processor's first control message is 

AEND 

the result is a file copy. This sequence implies that the 
UPDATE control message defined both the "from" and "to" 
tapes. 



When the END control message is encountered, UPDATE 
terminates by copying the remainder of the "from" file onto 
the "to" file, provided that both the "from" and "to" fields 
on the UPDATE control message were defined. If the pro- 
cedure is to copy from "C" to "to", UPDATE just terminates. 

When the UPDATE processor's first control message is not 
END, the procedure followed depends on the particular 
UPDATE control message encountered. 

UPDATE CONTROL MESSAGES 

ARE PLACE name 

The REPLACE control message directs UPDATE to copy the 
"from" file up to the routine defined by the label "name". 
UPDATE then reads the next input image, to determine if it 
is a LABEL control message (see LABEL control message 
described in Section 2). If the control message is LABEL, 
the new label is written on the "to" file and UPDATE skips 
the label "name" and its entire routine on the "from" file. 
If the input image is not a LABEL, the label "name" from 
the "from" file is copied onto the "to" file and the remain- 
der of the routine on the "from" file is skipped. The routine 
that is to be inserted (the replacement) is then copied from 
the "C" file to the "to" file. 

AINSERT name 

The INSERT control message direct UPDATE to copy the 
"from" file onto the "to" file, up through the label "name" 
and its corresponding routine. UPDATE then performs a "C"- 
to-"to" copy. 

ADELETE name 

The DELETE control message directs UPDATE to copy the 
"from" file onto the "to" file, up to "name". The label 
"name" and its entire routine are then skipped. 

ASCAN name 

The SCAN control message directs UPDATE to scan the 
"from" file for the label "name". 



AS KIP 



±nnnnn 



The SKIP control message directs UPDATE to skip either for- 
ward (+nnnnn) or reverse (-nnnnn) "nnnnn" records, where 
a record implies from one label record to another. 

When UPDATE has completed its file maintenance function, 
it will provide a map of all of the labels that the "to" file 
contains. 



The "+" is not required when nnnn references a skip for- 
ward. 
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10. SYSTEM GENERATION 



GENERAL DESCRIPTION 

The system generation routine (SYSGEN) is a free-standing 
processor that will generate a real-time monitor system 
(MONITOR) either on a RAD File or on magnetic tape 1, 
channel A (or W, for the 900 Series). When SYSGEN is 
completed, the MONITOR system will operate from MTOA (or 
from MTOW, for the 900 Series) or the appropriate RAD unit. 

SYSGEN is an absolute program with its own bootstrap and 
loader and is the first record on the SYSGEN tape, which 
is placed on tape 0, channel A (or W) . The program is 
loaded into high core when a magnetic tape fill operation 
is performed. 

The minimal peripheral requirements for SYSGEN are: 

1 . A magnetic tape on Channel A (MTOA or MTOW) 

2. A typewriter on Channel A (TYIA or TYIW) 

3. One of the following (system device): 

a. A RAD File 

b. A magnetic tape on channel A (MT1A or MTIW) 

Optional peripherals are: 

1. A card reader on channel A (CR1A or CRIW) 

2. A line printer on channel A (LPIA or LPIW) 

SYSGEN CONTROL MESSAGES 

Before SYSGEN begins, the operator must supply the 
SYSGEN operating parameters by responding to several in- 
formation request messages and by defining the system con- 
figuration of the ultimate MONITOR. These SYSGEN-time 
control messages provide the user with a dynamic system 
generation capability. 

INPUT/OUTPUT REQUESTS 

SYSGEN initially requests the device from which the con- 
trol messages will originate, by typing the message: 

INPUT FROM 

The reply may be one of the following (followed by a period 
or carriage return): 

1. TY (implies typewriter 1, channel A or W) 

2. CR (implies card reader 1, channel A or W) 



Any reply other than the above implies typewriter, and the 
error message 

INPUT NOT 'TY' OR 'CR', 'TY' ASSUMED 

will be typed. 

SYSGEN then requests the device on which the control mes- 
sages, diagnostics and other information will be displayed 
by typing: 

OUTPUT ON 

The reply may be one of the following (followed by a period 
or carriage return): 

1. TY (implies typewriter 1, channel A or W) 

2. LP (implies line printer 1, channel A or W) 

Any reply other than the above implies typewriter, and the 
error message 

OUTPUT NOT 'TY' OR 'LP', 'TY' ASSUMED 

will be typed. 

MONITOR SYSTEM CONFIGURATION 

The first control message required by SYSGEN must supply 
information about the MONITOR system configuration. The 
form of this message is given below . 

ABASE-MACHINE, SYSTEM-DEVICE, DISC-SIZE, CHECK 
BASE-MACHINE is either 910,920,925,930, or 9300 

SYSTEM- DEVICE is MTOA(MTOW) or DFnc (where: 1 n 2 
and c=A,W, B,Y,C,...,H) 

DISC-SIZE is the number of characters on a RAD 

File, nnCK (needed only if the SYSTEM- 
DEVICE is a RAD File); 
where: nn = 5, 10, 26, 68, etc., 
C = nn* 100, and 
K = C* 1000 
e.g., 5CK (i.e., 500,000) 



CHECK 



is an optional request for SYSGEN to 
read the system output just written and 
to compare it with that which should 
have been written. 



Typical messages are 

A9 10, MTOW, CHECK. 
A930, MTOA. 
A9300,DF1A,47CK,CHECK. 



All references herein to any device on channel A or B also 
apply to channel W or Y for the 900 Series Computers. 



All SYSGEN control messages begin with a A in character 
position 1 and end with either a period, a carriage return, 
or a maximum length of 80 characters. 
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RESIDENT I/O DRIVER REQUESTS 

The second control message required by SYSGEN supplies 
the information concerning what peripheral device drivers 
are to be resident at all times for this particular MONITOR 
system. 

The control message appears as one of the following: 



ADRIVERS DEVICE-CODE(S) 
ADRIVERS* DEVICE-CODE(S) 



where: 



DEVICE-CODE(S) 



DRIVERS 



DRIVERS* 



blank (the typewriter, NO I/O 
operation, and the SYSTEM- 
DEVICE drivers are automatically 
assumed, even if the field is not 
blank but does not request these 
three drivers). 

= DF and/or MD, implies disc/drum 
driver. 

= TY and/or PR and/or PP, implies 
typewriter/paper-tape driver. 

= CR and/orCP, impliescard reader/ 
card punch driver. 

= LP, implies line printer driver. 

= MT, implies magnetic tape driver. 

= PL and/or NO, implies NO I/O 
operation. 

implies that I/O error recovery 
during real-time processing is re- 
quested. 

implies that no I/O error recovery 
during real-time processing is re- 
quested. 



Typical messages are 

ADRIVERS 

ADRIVERS* 

ADRIVERS 



MT,CR,CP,TY 
DF,MT,NO 



SYSTEM STANDARD ASSIGNMENT GENERATION 

SYSGEN proceeds to load the resident MONITOR and 
iNSTALIation package according to the BASE-MACHINE 
designation. The INSTALIation package contains the in- 
formation needed for dynamic generation of theUnit Avail- 
ability Table (DAT), Unit Name Table (UNT), standard 
assignment portion of the resident symbol table (SYMTAB), 
and the FCBs necessary to manage the system files. 



The UNT contains the device names for all devices defined 
by INSTALIation and a corresponding UAT entry which con- 
tains the channel and device number bit settings. Each entry 
in the UAT also references its particular I/O driver. 

STANDARD ASSIGNMENT MODIFICATIONS 

After generation of SYMTAB, additional standard assign- 
ments can be added to SYMTAB as well as modifications to 
all the existing standard assignments, except for 

R\PERM (permanent file) 

R\PROC (processor file) 

R\PROK (MET A- SYMBOL Proc deck file) 

R\PRIL (primary library file) 

R\SECL (secondary library file) 

R\SWAP (swap file) 

R\CONS (system console file) 

NO (NO I/O operation) 

by modification control messages of the form 

AASSIGN STANDARD-ASSIGN-NAME = ASSIGNMENT 



STANDARD-ASSIGN-NAME = from 1- to 8-character 
operational label (e.g., ABC, A/\XYZT). 

ASSIGNMENT= a 4-character device name which is 
defined in UNT, or device NO. 

= a 1- to 8-character name which may 
be defined in UNT or, if not in UNT, 
must be in SYMTAB as a previously de- 
fined STAN DARD-ASSIGN- NAME 



Typical examples are 



AASSIGN 
AASSIGN 



MX = LPIA 
10= MX 



Each field must be separated by a comma. 



As many of these modification or additional standard assign 
control messages may be supplied as are needed. 

The modification control messages are terminated by a FIN 
control message of the form 

AFIN 

USER HOLD FILES (DISC) 

If the SYSTEM-DEVICE is a RAD File, SYSGEN needs to 
know if the RAD File contains user-defined "HOLD" files. 
SYSGEN will type: 

ARE THERE HOLD FILES 

The answer to be typed in is either YES or NO. If the an- 
swer is YES, the HOLD files are retained when generating 
the MONITOR system. If the answer is NO, the MONITOR 
system is generated and the remainder of the RAD File is not 
preserved. If the response is neither YES nor NO (e.g., YAS, 
NO), SYSGEN will continue with the request until the re- 
sponse is YES or NO. 
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GENERAL SYSTEM GENERATION 



SUMMARY OF SYSGEN MESSAGES 



SYSGEN determines which I/O drivers are required (and 
what the BASE-MACHINE is) and will load them as part of 
the basic resident MONITOR. 

SYSGEN analysis is then completed, except for generating 
the MONITOR system on the SYSTEM-DEVICE. The BASE- 
MACHINE bootstrap is loaded and written on the SYSTEM- 
DEVICE. The MONITOR is then written, followed by the 
INSTALIation information. 

SYSGEN can then use the MONITOR for all of its I/O for 
the remainder of system generation. The remainder of the 
system generation depends on the BASE- MACHINE to deter- 
mine whether the remainder of the MONITOR system is for 
a 900 Series or a 9300 Computer. 

The appropriate overlay loader is loaded into core to serve 
as the loader for the remainder of the system generation. 
The MONITOR is then informed that SYSGEN is to be the 
executive system. All of SYSGEN is released from core for 
loading purposes, except for the executive control. 

The SYSGEN input tape (MTOA) is positioned to the I/O 
drivers. All MONITOR routines, processors, and I/O 
drivers which were not previously loaded as part of the 
basic MONITOR are loaded and put on the processor file 
(R\PR0C) in a semi-absolute format. When the META- 
SYMBOL Proc decks are encountered, they are put on the 
Procdeck file (R\PR0K). 

SYSGEN continues by generating the primary library 
(R\PRIL)and secondary library (R\SECL) files in semi-absolute 
format. 

When the ENDGEN record is read from the input tape 
(MTOA), SYSGEN completes the SYSTEM-DEVICE initial- 
ization. MONITOR is then informed that SYSGEN has 
finished and that the MONITOR executive routine is in 
control. 



SYSGEN contains variouserror, I/O, and general-information 
messages which may occur during a SYSGEN operation. 

INPUT/OUTPUT 

The following table defines the type of message, its input 
source, and where it is displayed (see INPUT FROM and 
OUTPUT ON messages, discussed in "Input/Output Re- 
quests.): 



Input 


Out. 






From 


On 


Message Type 


Where Displayed 






Input control message 


Not displayed 


TY 


TY 


Error message 


On TY1A 






Installation map 


On TYIA 






Input control message 


On LP1A 


TY 


LP 


Error message 


On TYIA and 
LPIA 






Installation map 


On LPIA 






Input control message 


On TYIA 


CR 


TY 


Error message 


On TYIA 






Installation map 


On TYIA 






Input control message 


On LPIA 


CR 


LP 


Error message 


On TYIA and 
LPIA 






Installation map 


On LPIA 



ERROR AND I/O MESSAGES 
The SYSGEN error and I/O messages are as follows: 



Message 


Cause 


Results/Correction 


NO 'CONTROL INFO' 


The first control message (BASE- 


SYSGEN will halt withA-reg.=01 




MACHINE, SYSTEM-DEVICE, 


Determine correct control message 




etc.) is completely blank. 


and clear halt 


'CONTROL INFO' NOT COMPLETE 


The first control message (see 


SYSGEN will halt with A-reg. 




above) does not contain a 


=02. Determine correct control 




SYSTEM- DEVICE 


message and clear halt. 


DISC SIZE UNKNOWN, OR NOT DEFINED 


The first control message (see 


SYSGEN will halt with A-reg. 




above) defines SYSTEM-DEVICE 


=014. Determine correct control 




as DFnc(disc) and the size is 


message and clear halt. 




either unknown or not present. 






(where: 1 < n < 2 and 






c =A,W,B,...,H) 
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Message 



Cauj 



Results/Correction 



OUTPUT DEVICE NOT 'DISC OR 'MTOA-W 



BASE-MACHINE I.D.UNKNOWN 



ASSIGN/FIN 'CONTROL INFO' MISSING 



NO DRIVER CONTROL MESSAGE 



XX IS ILLEGAL DRIVER REQUEST 



POSSIBLE SYS-GEN ERROR (5) 



XXXX DEVICE NOT AVAILABLE 



MOD.OF A NON-STANDARD ASSIGN SYMB. 



MOD.OF A NON-DF/MD ASSIGN, TO=DF/MD 



MOD.OFSTAND.ASSIGN,DEV.NOT FOUND 



ILLEGAL MOD.TO STANDASSIGN/SYMB. 



INPUT NOT 'TY' OR 'CR', 'TY' ASSUMED 



OUTPUT NOT 'TY' OR 'LP', 'TY' ASSUMED 



MTnA ERROR 



The first control message (see 
above) has an illegal SYSTEM- 
DEVICE definition. Must be 
MTOA, MTOW, or DFnc where: 
l<n<2 and c=A, W, B, Y, ..., H. 

The first control message BASE- 
MACHINE is not defined as 910, 
920, 925, 930, or 9300. 

A modification assign control 
message is incomplete, or the 
control message was supposed to 
be "AFIN". 

The second control message re- 
quired by SYSGEN must be the 
control message DRIVERS. 

The DRIVERS control message has 
requested an I/O driver("XX") 
which is unknown to SYSGEN. 

SYSGEN internal information 
missing when generating UAT. 
Caused by a possible hardware 
malfunction. 



When generating the symbol 
table for standard assignments, a 
standard assignment references a 
nonexistent device "XXXX" . 

A modification control message re- 
quests an assignment modification 
to a symbol which is not a stan- 
dard assign. 

A modification control message re- 
quests a modification of a standard 
assignment (which was not origin- 
ally assigned to a disc or drum) to 
be assigned to a disc or drum. 

A modification control message re- 
quests a modification of a standard 
assign and the peripheral device is 
unavailable. 

A modification control message re- 
quests an assignment which refers 
to a standard assignment which 
cannot be assigned to. 

Incorrect response to the initial 
SYSGEN request: INPUT FROM. 

Incorrect response to the initial 
SYSGEN request: OUTPUT ON. 

(0 < n < 1) magnetic tape read or 
write error. 



SYSGEN will halt with A-reg. 
=03. Determine correct control 
message and clear halt. 



SYSTEN will halt with A-reg. 
=013. Determine correct control 
message and clear halt. 

SYSGEN will halt with A-reg. 
=04. Determine correction and 
clear halt. 



SYSGEN will halt with A-reg. 
=016. Determine what the con- 
trol message should be (even if it 
is just 'A DRIVERS')andclearhalt. 

SYSGEN will ignore the request 
arKl will continue processing the 
remainder of the control message. 

SYSGEN will continue as though 
no error had occurred. If the 
error is determined to be catas- 
trophic, the entire SYSGEN op- 
eration should be restarted. If the 
error persists, check the hardware. 

Standard assign from INSTALIation 
is ignored and the generation con- 
tinues. 

SYSGEN ignores the modification 
and continues processing by ob- 
taining the next control message. 

SYSGEN ignores the modification 
and continues processing by ob- 
taining the next control message 



SYSGEN ignores the modification 
and continues processing by ob- 
taining the next control message. 

SYSGEN ignores the modification 
and continues processing by ob- 
taining the next control message. 

SYSGEN assumes 'TYIA' as its in- 
put and continues. 

SYSGEN assumes 'TYIA' as its 
output and continues. 

SYSGEN halts with A-reg.='MTE' 
(446325). Clear halt for retry. If er- 
ror persists, check tape and tape 
drive. 
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Message 


Cause 


Results/Correction 


MTnA 


NOT READY 


(0 < n < 1) magnetic tape is either 
physically not ready or is file- 
protected for a write attempt. 


SYSGEN waits for the condition to 
be corrected and then continues. 


CRIA 


ERROR 


Card reader error; e.g., validity 
check, feed check, or read check. 


SYSGEN halts with A-reg.='CRE' 
(235125). Correct condition and 
clear halt to continue. 


CRIA 


NOT READY 


Card reader is not ready. 


SYSGEN waits for the condition to 
be corrected and then continues. 


LPIA 


ERROR 


Line printer error. 


SYSGEN halts with A-reg.='LPE' 
(434725). Correct condition and 
clear halt to continue. 


LPIA 


NOT READY 


Line printer is not ready or on 
line. 


SYSGEN waits for the condition to 
be corrected and then continues. 


DFnc 


ERROR 


Disc n (1 < n < 2) on channel c 
(=A,W,B,Y,C,...,H) reader 
write error. 


SYSGEN halts with A-reg.='DFE' 
(242625). Clear halt for retry. If 
error is persistent, check disc for 
hardware problems. 


DFnc 


NOT READY 


Disc n(l < n < 2) on channel c 
(=A,W,B,Y,C, ...,H)not ready. 


SYSGEN waits for the condition to 
be corrected and then continues. 


PERIPHERAL-DEVICE XXXX NOT AVAILABLE 


A peripheral device which has 
been defined for SYSGEN I/O 
use is not available (XXXX = de- 
vice defined). 


SYSGEN cannot continue. The en- 
tire SYSGEN operation must begin 
over, with the correct devices de- 
fined. 



GENERAL INFORMATION MESSAGES 

The general information messages produced by SYSGEN 
constitute a map of INSTALIation. This map displays 
the information contained in the UNT, DAT, and 

Case 1; (where SYSTEM-DEVICE = DFIA) 



SYMTAB tables and also the MONITOR system character- 
istics. 

Monitor System Characteristics 

The following is an example of the MONITOR system char- 
acteristics: 



bASt MACHINE = QoSCfj 

SYSTEM DEVICE= DPI A 

** tCHCj-CHcCK 

R\NACH = 60CnCCC«J 

SECTOK KAF = C0J7/4 (ClSC-AEE^'tSS) 

T9IAL SEClORS= uU^nCO' < * 100 ^-3*^15 PEk StCTfjR w4 CnAR.PER /.ft R b'lNP . CH A k , ( QCT AL 3 ) 

Case 2: (where SYSTEM- DEVICE = MTOA) 

BASE MACHINE = 9«i5 

SYSTEM LEVICEs M{Uk% 
NO tCH0-cntC^ 

R\MACh = ;:0CCOUC(J 



BASE-MACHINE 
SYSTEM- DEVICE 
**ECHO-CHECK 
NO ECHO-CHECK 
R\MACH 

SECTOR MAP 
TOTAL SECTORS 



The machine in which the MONITOR system is to operate. 

The peripheral device where the MONITOR system resides. 

SYSGEN checks what was written on the SYSTEM-DEVICE against that which should have been written. 

As above, except that no check is made. 

A flag word used by the MONITOR I/O drivers and system processors to determine if I/O error recovery 
during real-time processing is requested, and also what the BASE-MACHINE is. 

Address (octal) of the disc sector where the MONITOR disc-sector-map is maintained. 

The total number (octal) of sectors that this particular disc contains. 
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Unit Name Table Map (UNT) 

The following is an example of the UNT map: 



J ^ 2 b i 

•i ** 2 ? 6 
J ^t i 3 C 

:i Ai a ii 
3 4 j a t 

3<*3bG 

3 4 362 
343b4 
3444C 



Lt V i Cc 

M :^ A 
^'L2l^ 

C P J A 

^'^ iA 

f 1 1 'A 
r 1 ci A 

''TiA 

f T 3" !»- 
^ I 6 A 
M 'J 1'' 
^' ( bM 
M 5 '^ 

f 'f C A 
1^ T 7 A 
^ 1 7 tv 

hPc?r 
^ I Cc 



i A D D K b : 

3 4 u <; fc 

J 4 ij J u 

o -^ U w o 

3du34 
3 4 U 3 *+ 
.3 4 ( j - ir 

4 U C <L 

3iob4 

04u;i4 

34obC 

3 4oeu 

<!♦ k^ t C 

3 ^ o t .i; 
3 4 u 6 ^r 
d C c -i 
3 4 u t 4 
J4Gcfc 
.5 4 C t b 
3 4 L: 7 
C ^ Ij / I 
04o7 t 
.5 4U7^ 
3 A 1 5 'J 



U U C U U J 2' 6 

uGCjUU027 

G G G b L 2 / 

U C u, G 4 

G G C' 4 o 

G G G G 1 1 

G IJ G U G 1 1 

u JGuUGl 2 

GUuoGCi*^ 

G G t.J I 3 

GQGGGG 1 3 

U U U i 4 

GGG0G0i4 

G o i> U U Ci i 3 

I. G G U G I :> 

G G t G G 1 6 

uGOuGUie 

LULGl.UJ 7 

GCUGLG17 

CUGGGl^/ 

uUGGL 1 <i: 7 

■ . f ; G L- i C b 

GCOGuIOd 

G 4 C U L i 



GU 

OG 

00 

G6 

G6 

14 

14 

14 

14 

14 

14 

14 

14 

i4 

14 

X4 

14 

14 

14 

UD 

!.n 

3 
G3 
14 



U R I V 1 1* 

HAGISC 
KvCIbG 
KvGISC 

(V \ C A i^ U 
^<< \CAwD 
H \ T A P t 
rt\T APE 
rV \ T A P t 
K\T APE 
K \ T A P t 
K \ 7 A P t 
K \ T A F E 
K \ T A H t 
i-t \ T A P E 

*^ \ r A p t 

K \ T A P E 
r^AFAPE 

■^VT APE 
R \ T A P E 

S \ L I S C 

P s, P A P K 
P \ P A P H 
kNTAPE 

S Y K T A b 



where: 



ADDRS (1st) = Core address of UNT's DEVICE entry 

DEVICE = Actual name of DEVICE 

ADDRS (2nd) = DEVICE reference address to UAT 

CHAN-DEV = The channel EOM bits with UNIT 
NUMBER 

I/O = Index to the I/O DRIVER name table 

DRIVER = The DEVICE name is connected to its 

appropriate I/O DRIVER 



Symbol Table Map (SYMTAB) 

The following is an example of the SYMTAB map: 



CHAlNSGaijt:s<Lt:>:<FGd = tf>s NAh^t t <E G &: = &> s Ai-UPS : DEVICE s A CDRS s Ch AN-L'E V : I /O S URIVER 



3 5 3 1 
35025 
3b0«: 1 
3bClb 
3 4/71 
3476b 
3^742 
34fcbl 
34cl7 
34fc j 3 

34be4 

34bb4 
3 4bbr 
34b44 
3 4 b 4 y 
34u2^ 
33547 
3 3 b 4 3 
3 3b 3 7 
33b33 
3 3 b 2 / 
33523 
33bl7 
33313 
uOGCr 



^? 

L^ 
C2 

G2 
2 
G2 
13 
C2 
G2 
12 
02 
G3 
U3 
U3 
3 
IG 
iO 
IC 
10 
10 
10 
10 
IG 
IG 



Ne 
Kb 
i\i5 
isfc 
f\'b 

NO 
i\t) 

^C3 
N6 
Nfc 
i\t 
N& 
\t 
NO 
No 
NO 
NO 
NO 
NO 
NO 
NO 
NO 



YES 

YES 

YES 

YtS 

YES 

tES 

YES 

NO 

YES 

YES 

NO 

rtS 

YES 

YES 

tES 

YES 

NO 

Nt 

NO 

NO 

NO 

i\0 

N? 

NO 

NO 



CGQOGCCl 

i234te7a 

L;GG1CGLu 

s 

VkvX YZ 

AbCLEf- Gr 

h 

K\Sift.AP 

EO 

El 

XI 

K\0 VKL 

P\SbGL 

K \ P K 1 L 
P \ P K K 
K\Pr<OC 
K\ lOCh 
KXiOl fc 
R \ P K L 
K \ M A C ^ 

P \ G E K i^ 
K\i_GM 
P \ o N T 

k \ u A r 

PVKESl 



n:: 
Ne 

NO 

N3 

NO 

NO 

NO 

YES 

K'1 

NO 

YES 

NO 

NLi 

Nc 

Nt 

k^ 

NO 

Nfj 

NO 

\8 

NO 

NO 

NO 

NO 

NO 



3 '^ 3 5 ''4 
3'*3b4 
343b4 
34354 
3 « 2 6 2 
3'i2fc2 
3 4 250 
35 117 
3 4 ^ 5 iJ 
34262 
351 lb 
3432C 
34320 
3<+3?L/ 
34320 
3-^320 
3 3 4 4 1 
33451 
33511 
33blG 
33506 
33774 

6Z777 

33512 



>i T 7 w 
M T 7 W 
lil 7i«< 
l-i T 7 ^ 
CP t A 
C P 1 A 

NO 

DPI A 

NO 

CRl A 
DF lA 
MTO A 
i1 T W 
MTOt^ 
mtGa 
■^ T 'rt 



34C72 
34C72 
34072 
3 4 CJ 7 2 

3 4 3 t: 

3<in3n 
3402b 
« U 3 
3 4 3b 

34G54 

0^034 

34054 
3 4 5 4 
3 4 05 4. 



i 7 
00000017 
00000017 
00C0Q0i7 
(J G u G c 
u U u G c 
00 GO 
0000002b 
G 
OOOOOGGo 
00000026 
iJ i G 
UOUOUOIC 
U G u 1 
1 L 
OGOOOuiG 



14 
14 
14 

14 

05 
Ob 
22 
CO 
22 
Ofe 
CO 
14 
14 
14 
14 
14 



R\l APt 

PVTAPE 

R\1 APE 

PV7APE 

K \ C A K D 

K\CARD 

R\NO 

RVDISC 

P\N9 

R\GARD 
RViJlSC 

R\ r APE 

R\l APE 
PVTAPE 
P\TAPE 
RMAPE 



where: 



CHAIN = the core address of the next symbolic NAME in the SYMTAB mop. 

CODE = the code given for the various types of SYMTAB entries, e.g., 

02 = FCB reference (not disc or drum and is reassignable) 
12 = FCB reference originally to a disc or drum (is reassignable) 
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03 = SYSTEM-FCB reference (cannol- be reassigned nor can a file name be assigned to it) 

13 = SYSTEM-FCTB reference (same as for code 03, but this reference is ignored by SYSGEN if the 

SYSTEM-DEVICE is MTOA. 
10= MONITOR and INSTALlation entries. 

<LO> = NO if "NAME" is not same file as "LO" file. 

= YES if "NAME" is the same file as "LO". 

<FCB = 2> = NO if "NAME" is not an FCB reference. 

= YES if "NAME" is a 2-word FCB reference to the UAT. 

NAME = The 1-8 character symbolic name. 

<FCB = 6> = NO if "NAME" is not an FCB reference. 

= YES if "NAME" is a 6- word FCB reference (disc or drum). 

ADDRS(lst) = The core address of UNT's DEVICE entry if "NAME" is an FCB reference. 

= The core address of the MONITOR or INSTALlation definition if "NAME" is not an FCB reference. 

Note: The remainder of a SYMTAB entry information line is blank if the "NAME" is not an FCB reference. (See UNT 
example for explanation of remainder of a SYMTAB entry's information line if "NAME" is an FCB reference.) 

SYSGEN EXAMPLES 

The following are examples of a SYSGEN operation with modifications to standard assignments and subsequent addition of stan- 
dard assigns: 

Example 1: 

INPUT FROM TY. 

OUTPUT ON LP. 

A910 DF1A,5CK. 

ADRIVERS. (DF, TY, and NO assumed) 

AASSIGN A= DFIA 

AASSIGN TEMPORARY = A (actual file name = TEMPORAR) 
AASSIGN X3 = NO 
AFIN 

Example 2: 

INPUT FROM CR. 

OUTPUT ON TY. 

A9300 MTOA, CHECK. 

ADRIVERS DF,CR, NO. (MT, and TY assumed) 

AASSIGN XI = MTIA 
AASSIGN X2 = MT2A. 
AASSIGN X3 = MT2A, 
AASSIGN 12345678 = X3 
AASSIGN X4= 12345678 
AFIN 
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APPENDIX A 



SDS STANDARD BINARY LANGUAGE 

The following descripfion specifies a standard binary language for SDS 900 Series and 9300 Computers. This language 
is intended to be both computer-independent and medium-independent. Thus, the language provides for handling 
Programmed Operator definitions and references, even though the 9300 Computer does not have this hardware feature; 
similarly, there is a provision for relocation relative to blank COMMON. 

In the following description of the language, a file is the total binary output from the assembly/compilation of one 
program or subprogram. A file is both a physical and logical entity, since it can be subdivided physically into unit 
records and logically into information blocks. While a unit record (in the case of cards) may contain more than one 
record, a logical record may not overflow from one unit record to another. 



1 . CONTROL WORD - first word in each type of record 



Type (T) 


1 


Word Count (C) 


Mode 
(Binary) 


Folded Checksum (FC) 









101 




2 


3 


4 8 


9 11 


12 




23- 



Field 

Contents 
Bit Number 



T Record Type 

000 Data record (text) 

001 External references and definitions, block and program lengths 

010 Programmed Operator references and definitions 

01 1 End record (program or subroutine end) 
101 Data Statement Record 

(other codes unassigned) 

C = total number of words in record, including Control Word 

Note that the first word contains sufficient information for handling these records by routines other than the loader 
(that is, tape or card duplicate routines). The format is also medium-independent, but preserves the Mode indicator 
positions desirable for off-line card handling. 

An exclusive OR checksum is used. If the symbol(u)is used to denote exclusive OR, and W. denotes the ith word in 
the record (1 < i < C), then ' 

FC = (W,)o. „ ® (S)^ , , ® (S) ,2.23 ® 07777 

where 

S = W2®W3® ... ®W^ 

2. DATA RECORD FORMAT (T = 0) 
Word 1 



Control 
Word 



Record 
Type a) 



3 s C 2 30 



000 



Mode 
(Binary) 



101 



Folded Checksum 



2 3 4 

Word 2 



8 9 



11 12 



23 



Load 

Address 

Word 



1 


Data Word 
Modifiers (M) 


Load Address 
Modifiers (A) 


Load Address (Relative or Absolute) 














1 4 


5 8 


9 23 
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The presence of bits in field M indicates the presence of words n+3, n+4, n+ 5, and n + 6 (shown below): 

If bit position 4 contains a 1, word n+3 (load relocation) is present. 

If bit position 3 contains a 1, word n+4 (COMMON relocation) is present. 

If bit position 2 contains ci 1, word n+5 (POP relocation) is present. 

If bit position 1 contains a 1, word n+6 (special I/O relocation) is present. 



Data 
Word 1 



Word 3 



Instruction or Constant 



23 



Words 3 through n + 2 contain instructions or constants (where 1 ^ n ^ 24) 



Load 
Relocation 



Word n + : 


3 




Load Address Relocation Word (present iff (M) n 1 = 1) 









23' 



COMMON 
Relocation 



Word n + 4 



Blank COMMON Relocation Word (present iff (M) n 2 = 2) 



23 



Programmed 

Operator 

Relocation 



Word n + 5 



Programmed Operator Relocation Word (present iff (M) n 4 = 4) 



23 



Special 

I/O 

Relocation 



Word n + 6 




Special Input/Output Operation Relocation (present iff (M) n 8 = 8) 







23' 



Words n + 3 through n+6 are modifier words. Each bit in each of these words corresponds to a data word; that is, 
bits through 23 of each modifier word correspond to data words 3 through n + 2 (where 1 < n < 24.) A bit set to 
a I in a modifier word indicates that the specified data word requires modification by the loader. There are four 
types of modification (and, hence, four possible modifier words) which are indicated in data records. The pres- 
ence of a modifier word in a data record is indicated by the M (data word modifier) field in the load address 
word. 

The load address is subject to modification, as indicated by the A field of the load address word, as follows: 

(A) 0, absolute 

(A) n 1 = 1^ current load relocation bias is added to load address 

(A) "2= 1, currentCOMMON relocationbiasisaddedto loadaddress/theremainingbitsof Aareunassigned 

(A) =3, illegal 
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3. EXTERNAL REFERENCES AND DEFINITIONS, BLOCK AND PROGRAM LENGTHS (T = 1) 
(Includes labeled COMMON, blank COMMON and program lengths) 



Word 1 



Control 
Word 



Record 
Type (T) 


i 


4 <C <31* 


Mode 
(Binary) 


Folded Checksum 


001 







101 




2 


3 


4 8 


9 11 


12 




23' 



"^ From 1 to 10 items per record 
t 1- to 8-Character Label 



COMMON 

Length 

or Program < 

Length 

Item 



*^ 1 



8 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 


5 
Length Word 


6 


11 


12 


17 


18 23 


Item 
Type 


Wi/M,. 


B 


C 




Length of Program 


or COMMON Block (L) 


00 


00000 









23 



B = 1 if (L) is program length 

C= 1 if (L) is length of a labeled COMMON block 



1- to 8-Character Label 



External 

Reference 

Item 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 







5 


6 




11 


12 




17 


18 




23' 



Chain Word 



Item 
Type 


■ 


Address Mod- 
ifiers (A)** 


Address of Last Reference 


01 


000 







12 4 5 



8 9 



23 



External 
Definition ' 
Item 



** See data record, load address word, for interpretation, 
1- to 8-Character Label 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 







5 


6 




11 


12 




17 


18 




23' 



Value Word 



Item 
Type 


W/i. 


Address Mod- 
ifiers (A)** 


Absolute or Relocatable Value 


10 


000 






1 


2 4 


5 8 


9 


1 
23 



** See ddtn rfrord \r\r\A /-irlz-lrocc XA/nrr) fnr i nt<»rnrf»tnt inn 
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External symbolic definitions include subroutine "identification" as a subset and require no special treatment of 
subroutines with multiple names. 

^ 1- to 8-Character Label 



External 

Reference 

with 

Addend 

Word* 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 







5 


6 




11 


12 




17 


18 




23' 



Chain Word 










Item 
Type 


W/i, 


Address Mod- 
ifiers (A)** 


Address of Last Reference 


11 


000 






1 


2 4 5 8 


9 




23' 



Addend Word 




w//////mm/////M 


Value of Addend 


000 000 000 





"-0 



8 9 



23 



* One of these items for each unique reference; e.g., each of the following references is repre- 
sented by a separate item: A + 5, B + 5, B + 6, C+2, C+5 

** See data record, load address word, for interpretation. 



4. PROGRAMMED OPERATOR REFERENCES AND DEFINITIONS (T - 2) 

Word I 

Control 
Word 



Record 
Type (T) 


i 


4 <C <31** 


Mode 
(Binary) 


Folded Checksum 


010 







101 




2 


3 


4 8 


9 11 


12 




23" 



**From 1 to 10 items per record 
1- to 8-Character Mnemonic 



Internal 

Programmed 

Operator 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 







5 


6 




11 


12 




17 


18 




23* 



Item 
Type 


Sequence No. 


R 


Origin of Programmed Operator Routine 


00 




1 





1 2 



7 8 9 



23 



1- to 8-Character Mnemonic 



CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 



Programmed^ 

Operator 

Reference 






5 6 






11 


12 17 18 


23 


Item 
Type 


Sequence No. 


R 


i 


f///////////////////////////M 


f////i 


01 









000 000 000 000 000 




1 


2 7 


8 


9 






23 



44 



External 
Programmed 
Operator 
Definition 



1- to 8-Character Mnemonic 


















CI 


C2 


C3 


C4 


C5 


C6 


C7 


C8 


5 


6 




11 


12 




17 


18 




23 



Item 
Type 


Sequence No. 


R 


Origin of Programmed Operator Routine 


10 




1 




1 


2 7 


8 


9 23 



R = 1 iff origin of Programmed Operator routine is relocatable. The sequence number indicates the order in 
which the definitions or references occurred in the source program. 

5. END RECORD (T = 3) 

Word 1 

Control 
Word 



Length of 
Program 



Record 
Type (T) 




2<C ^5 


Mode 
(Binary) 


Folded Checksum 


Oil 







101 




2 3 
Word 2 


4 8 


9 11 


12 


23' 


t 
(S) 


Transfer Word 

Modifiers 

(M)* 


Wi/i 


1 + Maximum Value of Location Counter 







0000 





1 4 5 8 9 

* See data record description for interpretation. 



23 



(See') 



Name List 

Location 

Word 



T ransfer 
Word 



W///////////////////M. 


Name List Address (Relative) 


000000000 




8 


9 




23' 



(See^) 



mm, 


"BRU" 


Transfer Address 


000 


000001 




2 


3 


8 


9 


23' 



This may be followed by modifier words. 
6. DATA STATEMENT RECORD FORMAT (T = 5) 
Word 1 



Control 
Word 



Record 
Type a) 


Word 
Count (C) 


Mode 
(Binary) 


Folded Checksum 


101 


6<C<36 


101 




2 


3 




8 


9 11 


12 




23* 



!f S = 1,- Word 3 is the Name List Location Word and Word 4 is the Transfer Word. 
If S = 0, Word 3 is the Transfer Word, and the Nome List Location Word is omitted. 
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Word 2 



Load 

Address 

Word 



Increment (I)* 

(Least significant 9 bits) 


Load Address (Relative) 






8 


9 23 



* The increment (I) is added to the relative load address to obtain the next relative load address 
for a repeat load. 



Repeat 
Count Word 



(S) 




Increment (I) (Most 
/yy Significant 6 Bits) 



Repeat Count 
(R)** 



23 



* If S = 1, words 6 through C ( 6 < C < 36) are loaded relative to the labeled COMMON block's 
origin. 

If S = 0, words 4 through C (4 < C ^ 36) are loaded relative to the subprogram origin. 

** Data words 4 + 2S through C are repeatedly loaded (R) times in increments of (I) 

Word 3 + S 



CI 



C2 



COMMON 

Block 

Label 



C3 



C4 



Word 3 + 2S 


















C5 




C6 




C7 




C8 







5 


6 




11 12 




17 18 




23 



Word 4 + 2S 



Data 
Word 1 



Data 



23 



Words 4+2S through C contain constants 

7. BINARY CARD ORDERING 

The loader places certain restrictions on the permissible ordering of relocatable binary cards. That is, the re- 
quired ordering is as follows: 

a. Type 1 cards (containing definitions of external symbols) and Type 2 cards must physically precede all other 
cards (except Type 5; see below). 

b. Type cards 'must follow Type 1 and Type 2 cards. 

c. Type 1 cards containing references to externally defined symbols must then follow type cards. 

d. The last card in any deck must be a Type 3 card. 

e. Type 5 cards may appear anywhere, prior to the Type 3 card, as long as they follow the definition of the 
item into which data is to be loaded. 
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APPENDIX B 
900 SERIES REAL-TIME TAPE MONITOR 



The tape version of MONITOR is functionally similar to the 
disc version, but operates in a magnetic tape environ- 
ment without the mass storage and rapid access facilities of 
RAD Files. It provides interrupt and batch processing capa- 
bilities for real-time and genera I -purpose applications 
where RAD Files are not required. 

The "swapping out" of batch jobs is optional and, if desired, 
a magnetic tape unit must be dedicated for this purpose. 
Dynamic loading of programs during interrupt processing is 
considerably slower than for the disc version, due to the 
differences in tape and disc access and transfer rates. 



Library search and program load times are dependent on the 
number and size of the library programs, 

A minimum of two magnetic tape units are required, and, if 
the batch "swapout" facility is to be used, a third magnetic 
tape unit is needed. Also, if process-and-GO is desired or 
if META-SYMBOL encoded decks are to be assembled with 
symbolic corrections, then an additional magnetic tape unit 
is necessary. (See the table below.) 

The minimum hardware configuration for the tape MONITOR 
is identical to that for the RAD MONITOR, except that a 
magnetic tape unit is substituted for the RAD unit. 



Function 


Is Function Required By Job? 


Any assembly or 
compilation other 
than META-SYMBOL 
assembly of encoded 
program unit with 
symbolic corrections 
(see Section 1). 


No 


No 


No 


Yes 


No 


Yes 


Yes 


1 


Yes 


i 


<^m>. 


1 


META-SYMBOL as- 
sembly of encoded 
program unit with 
symbolic corrections 
(see Section 4). 


No 


No 


No 


No 


No 


No 


No 


Yes 


No 


Yes 


Yes 


Yes 


GO output and/or 
LOAD input (see 
Section 3). 


No 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


No 


Yes 


Yes 


Swapping of batch 
jobs during real- 
time operations 
(see Section 5). 


No 


Yes 


No 


No 


Yes 


Yes 


No 


No 


Yes 


Yes 


No 


Yes 


Number of tape 
units required 


1^^ 


2 


2 


2 


3 


3 


3 


3 


4 


4 


4 


5 



Includes only those tape units required by MONITOR. 
Real-time operations only; no batch processing to be done. 
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INDEX 



- A- 

Abort routine (see System abort routine) 

Accounting routines, 3 

ASA compatibility, 2, 6 

ASSIGN control message, 3, 23, 34 

- B- 

BACKSPACE control message, 8 

BASE-MACHINE designation, 33, 35, 36, 37 

Batch processing, 1, 10, 19, 23, 24, 47 

BI file, 4, 6, 7, n 

Binary card ordering, 46 

Binary output, 12 

Blank COMMON, 41, 43 

Blocked files, 32 

Bootstrap program, 2, 35 

Branch trace, 16 

Branch and mark trace, 16 

- C - 

C device (see Control message input device) 

Calling sequences (see Standard calling sequences) 

Card reader/punch operations, 21 

Carriage control, 18, 20, 22 

CEASE control message, 17 

Channel number, 18, 19 

Channel-active test, 19 

CHECK designation, 33, 39 

Comment cards, 6 

Comments field, 7 

Compile-and-go operations, 1, 12, 47 

Concordance listing, 5 

CONNECT control message, 9, 15 

CONNECT statement, 29, 31 

Control message input device, 4, 8, 19, 32 

Control message scan routine, 9, 24, 25 

Control messages, 1, 3 

ASSIGN, 3, 23, 34 

BACKSPACE, 8 

CEASE, 17 

CONNECT, 9, 15 

DATA, 8 

DATE, 4 

DEBUG, 16 

DELETE, 32 

DISPLAY, 17 

DRIVERS, 34 

DUMP, 17 

END, 32 

ENDFILE, 8 

EOF, 8, 12, 13, 14 

FIN, 8, 34 

FORTRAN, 6 

INCLUDE, 7, 10, 16 

INSERT, 16, 17, 32 

JOB, 3 



Control messages (cont.) 

LABEL, 5, 32 

LEAVE, 16 

LOAD, 4, 5, 6, 7, 8, 10, 16 

MESSAGE, 4 

METAXXXX, 5, 12 

PAUSE, 5, 8, 17, 24 

RELEASE, 3, 4 

RENTAB, 17 

REPLACE, 32 

REWIND, 8 

SCAN, 32 

SEG, 7, 10 

SKIP, 32 

SNAP, 16 

SYMBOL, 5, 6 

SYMTAB, 17 

TITLE, 4 

TRACE, 16 

TRAP, 16 

UPDATE, 32 
Control word, 41 
Core memory requirements, 2, 47 
Counters, 2 

- D- 

DATA control message, 8 

Data record, 41 

Data statement record, 41, 45 

Data type codes, 27 

DATE control message, 4 

DEBUG control message, 16 

Debugging, 1, 9, 16 

DELETE control message, 32 

Delimiter table, 25 

Device- independent files, 1 

Diagnostic routines (see Debugging) 

Disc files (see RAD Files) 

Disc sector map, 23, 24 

Disc sector map search routine, 23, 24 

DISC-SIZE designation, 33 

DISPLAY control message, 17 

DRIVERS control message, 34 

DUMP control message, 17 

Dynamic loading, 1, 47 

Dynamic storage, 2, 26 



- E - 



Empty-sector pool, 23, 24 
Encoded input, 4, 5, 8, 47 
END control message, 32 
End record, 41, 45 
End-action routine, 18, 19 
ENDFILE control message, 8 
ENDGEN record, 35 
EOF control message, 8, 12, 
EOM instruction, 18, 19, 38 
Error flags, 19, 21, 22, 23 



13, 14 
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Error messages, 2 

Executive, 1, 2, 17, 35 

Exit routine (see System exit routine) 

External definitions, 7, 11, 16, 41, 43, 44, 46 

External references, 15, 41, 43, 44, 46 

- F - 

File Control Blocks (FCBs), 4, 18, 19, 21, 23, 24 

File Description Tables (FDTs), 18, 19, 20, 21, 22, 23 

File maintenance, 2, 32 

FIN control message, 8, 34 

Fixed segments, 7 

FORTRAN, 1, 2, 8, 12, 22, 28 

FORTRAN control message, 6 

FORTRAN IV I/O specifications, 6 

Full trace, 16 



GLOBAL variables, 9 
GO file, 5, 7, 10, 12 



- G - 



- H - 



Hardware requirements, 2, 47 
HOLD files, 2, 3, 4, 34 

- I - 

l/O character testing modes, 22 

I/O operations, 1, 2, 15, 18, 19, 20, 21, 22, 23 

I/O processor (see System I/O processor) 

I/O specifications, 5 

Identification, 3 

Illegal strings, 26 

Implicit calls, 7, 30 

Implicit call processor, 2, 26, 27 

INCLUDE control message, 7, 10, 16 

Input control messages, 8 

INSERT control message, 16, 17, 32 

INSTALlation package, 34, 35 

Interlace requirements, 2, 47 

Interpretive processing, 16, 26 

Interrupt level, 2, 24 

Interrupt save block, 2 

Interrupt service routines, 1, 8, 9, 11, 15, 24 

Interruptable routines, 2, 15 



JOB control message, 3 



Key-in initiation, 17 



- J - 



- K - 



- L - 



LABEL control message, 5, 32 
Labeled COMMON blocks, 7, 43, 46 
LEAVE control message, 16, 17 
Library routines, 1, 47 



Line count, 19 

Line printer operations, 18, 19, 20, 22 

Linkage cell R\MACH, 31, 37 

Listing-object option, 5, 6, 12 

Listing-output file, 4, 5, 12, 13, 14, 19 

Load address word, 42 

LOAD control message, 4, 5, 6, 7, 8, 10, 16 

Load map, 6, 7, 10 

LOAD specifications, 6, 11 

Loader control messages, 7 

Loader control program, 2 

Local variables, 2, 28, 29, 31 

Logical peripheral device names, 3 

- M- 

Magnetic tape files, 1, 47 
Magnetic tape operations, 18, 20, 21 
Manual loading, 27 
Memory dump program, 2, 17 
Memory dumps, 1, 16, 17 
Memory Protection Feature, 1 
MESSAGE control message, 4 
META-SYMBOL, 1, 2, 8, 12, 35, 47 
META-SYMBOL I/O specifications, 5 
METAXXXX control message, 5, 12 
Mode indicator, 41 
MONARCH compatibility, 5 
MONITOR system configuration, 33 
Multiple program loading, 14 

- N- 
Name list location word, 45 

- O- 

Operational labels, 3, 8 
Operational table, 3, 8 
Operator actions, 17, 33 
Operator control messages, 8 
Overlay file, 2, 26 
Overlay loader, 1, 2, 10, 35 
Overlays, 7, 10, 13 

- P- 

Padding of partial words, 22 

Page ejects, 19 

Page headings, 4, 19 

Page numbers, 4, 19 

Paper tape operations, 18, 20, 21, 22 

PAUSE control message, 5, 8, 17, 24 

Pause routine (see System pause routine) 

Permanent files (see HOLD files) 

Physical peripheral device names, 3 

Pointers, 2, 18, 19, 23 

Postmortem dump program, 17 

POT word, 19 

Primary library, 1, 2, 7, 10, 16 

Primary library file, 26, 35 

Processor control messages, 5 

Processor file, 26, 35 
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Processors, 1, 17, 33, 35 
Program segments (see Segments) 
Programmed Operators, 41, 44 
Protected files, 1, 21 
Protected routines, 15, 28, 29, 31 
Push-down lists, 2 

- R- 

RAD Files, 1, 18, 20, 23, 33, 34, 47 

Random access RAD Files, 1, 18, 19, 23 

Real-time operations, 1, 11, 15, 19, 24 

Receiving sequences (see Standard receiving sequences) 

Record address, 18, 19 

Record control words, 23 

RECURSIVE declaration, 15, 29 

Reentrance chain, 2, 17 

Reentrance monitor, 2 

Reentrant routines, 2, 15, 19, 29, 31 

RELEASE control message, 3, 4 

Relocatable programs, 2, 6, 46 

RENTAB control message, 17 

REPLACE control message, 32 

Reserved files, 1, 3, 4 

Resident I/O drivers, 34, 35 

Resident loader, 2, 11, 26 

Resident loader control routine, 26 

Resident monitor, 1 

Resident routines, 1, 7, 11, 24 

Resident symbol table, 17, 25, 26, 38 

Resident symbol table search routine, 25 

Resident user's programs (see User's programs) 

REWIND control message, 8 

Rewind operation, 8, 19 

-S - 

S cards, 6 

SCAN control message, 32 

Scanning control messages, 24 

Scanning files, 18, 20, 21, 32 

Scratch files, 1, 5 

Secondary library, 1, 2, 6, 7, 11 

Secondary library file, 26, 35 

Sector address, 18, 19, 23 

SEG control message, 7, 10 

Segments, 2, 7, 10 

Semiabsolute loader, 2, 26 

Sequential RAD Files, 1, 8, 19, 20, 23 

Sequential file subcontrol messages, 8 

SKIP control message, 32 

SNAP control message, 16 

Snapshot dump, 2, 16 

Spacing magnetic tape, 21 

Standard assignments (see System standard assignments) 



Standard calling sequences, 27, 30, 31 

Standard receiving sequences, 28, 29, 30, 31 

Stop-character code, 22 

Subroutines with a variable number of arguments, 30 

Subroutines with no arguments, 31 

SYMBOL, 1, 2, 5, 6, 15 

Symbol table (see Resident symbol table) 

Symbol table search routine, 9 

Symbolic corrections, 12, 13, 14, 47 

Symbolic file names, 3, 32 

Symbolic input, 5, 6, 8 

Symbolic unit names (see Physical peripheral device names) 

SYMTAB control message, 17 

System abort routine, 8, 17, 24 

System BCD-to-binary conversion routine, 9, 26 

System control messages, 3 

SYSTEM-DEVICE designation, 33, 34, 35, 36, 37, 39 

System exit routine, 17, 24 

System files, 2, 26 

System generation routine, 32, 33 

System generation messages, 35, 36, 37 

System I/O processor, 1, 2, 19 

System labels, 4, 

System pause routine, 17, 24 

System reserved names, 9 

System standard assignments, 34, 39 

System UPDATE processor, 1, 2, 32 

- T- 

Temporary storage locations, (see Temps) 

Temps, 2, 19, 28, 29, 30, 31 

TITLE control message, 4 

TRACE control message, 16 

Transfer word, 45 

TRAP control message, 16 

Typewriter operations, 18, 20, 21, 22 

- U- 

Undefined external symbols (see Implicit calls) 

Unit Availability Table (UAT), 34, 37, 38, 39 

Unit designation, 18, 19 

Unit Name Table (UNT), 34, 37, 38, 39 

Unrecognized control messages, 9 

UPDATE processor control messages, 32 

Update program (see System UPDATE processor) 

User-defined control messages, 9 

User's files, 1 

User's programs, 1, 19, 20, 21, 22, 26 

Utility routines, 2 



- X- 



X cards, 6 
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